# AI Chatbot: Study a Quran page with the AI companion

Source: https://qurangallery.com/docs/chat/companion-mode

> Open a mushaf page beside the chat, tap a verse and ask about its meaning, tafsir or context. Editions include Hafs, Warsh, Qaloon, Douri and Shubah.

Quran Companion shows a mushaf page beside the chat, so you can tap a verse and ask about it. Sign in, open [`qurangallery.com/chat/companion`](https://qurangallery.com/chat/companion) and choose a mushaf edition to start.

## Open companion mode, step by step

1. **Sign in** to your Quran Gallery account — companion mode is part of the
   chatbot, which needs an account to start a conversation.
2. In the chat sidebar, select **Open Quran Companion** (or go straight to
   [`qurangallery.com/chat/companion`](https://qurangallery.com/chat/companion)).
3. Under **Choose a mushaf**, pick an edition. The screen splits: the mushaf
   page on one side, the chat on the other.
4. **Tap a verse** to ask about it, or tap one of the **suggested questions** for
   the whole page.
5. To come back later, select **Continue Quran Companion** on the chat's start
   screen — it reopens the edition and page you were reading.

## Choosing a mushaf

The companion landing page opens on **Choose a mushaf** — a gallery of mushaf
editions (Hafs, Warsh, Qaloon, Douri, Shubah, Urdu, and Tajweed). Pick the
edition you want to read _before_ the split-screen opens:

- **Search editions** by name, riwaya, or publisher with the search box.
- **Filter** by riwaya using the chips above the gallery (**All**, then each
  riwaya present).
- If you've read in companion mode before, a **Continue reading** strip near the
  top lets you jump back to where you left off in an edition.

Select an edition to open it in the split-screen reader.

## Reading alongside the chat

In companion mode the screen is split: the **mushaf page** on one side and the
**chat** on the other. As you read, you can ask the chatbot about the verses on
the page — a word, a phrase, the meaning of an ayah, or the context of the
passage — and your answers come with references, the same as a normal chat.

## Opening a specific page range

Companion mode is page-aware. A page range opens at a URL like:

```text
qurangallery.com/chat/companion/<mushafSlug>/page/<range>
```

- `<mushafSlug>` selects which mushaf edition you're reading.
- `<range>` is the page you want in view. Use a single page like `5`, or a
  two-page spread written with a hyphen like `5-6`.

This lets you jump straight to the page you're studying and keep the chat
focused on it.

## Asking about the page

Once a page is open, ask naturally — for example, "What is this verse about?" or
"Explain the word here." Because the page is in view beside the chat, you can
read the answer and check it against the text immediately. As always, the
responses are guidance: for fatwa or madhab-specific rulings, confirm with a
qualified scholar.

## Asking about one verse

Tap any verse on the page to focus the chat on it. A **context chip** appears
above the message box showing the verse you picked (for example,
`Al-Baqarah 2:255`) with the note `Context for your next question`. Your next
question is answered about that verse specifically. Select the **✕** on the chip
to clear the verse and go back to asking about the whole page.

## Suggested questions for the page

When the chat side is empty, companion mode offers one-tap **suggested
questions** so you don't have to phrase things yourself. Which ones appear
depends on whether a verse is selected:

| Suggestion                   | Shown                    | Asks for                                                      |
| ---------------------------- | ------------------------ | ------------------------------------------------------------- |
| **Explain `{verse}`**        | When a verse is selected | The verse's meaning and the context of its revelation.        |
| **Tafsir of `{verse}`**      | When a verse is selected | The classical tafsir, with key scholarly views.               |
| **Overview of page `{n}`**   | Always                   | Which surahs and verses are on the page, and what they cover. |
| **Main themes on this page** | Always                   | The main themes across the page's verses.                     |
| **Lessons & reflections**    | Always                   | Key lessons and reflections to take from the page.            |

Tap one to drop it into the message box, then send it.

## Companion keeps its own history

Companion reading sessions are saved separately from your regular chats. Your
ordinary conversations and your companion sessions each have their own list in
the sidebar, and the **Continue reading** strip on the landing page only tracks
companion sessions — so studying a mushaf never clutters your normal chat
history.

## Next steps

- [Open Quran Companion](https://qurangallery.com/chat/companion)
- [How to use Quran Gallery Chat for Islamic questions](https://qurangallery.com/docs/chat/using-chat)
- [Filter Islamic AI answers by madhab](https://qurangallery.com/docs/chat/schools-and-modes)
