> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heypharos.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Prompt monitoring: manage queries and analyze responses
> Manage the questions Pharos sends to AI platforms, review responses, analyze visibility in the heatmap, and compare brand rankings by topic.
Prompts are the questions Pharos sends to AI platforms on your behalf. Every response Pharos collects is analyzed to determine whether your brand was mentioned, how prominently it appeared, and what competitors were cited. The Prompts page is where you manage that question set and explore the results — add or remove prompts, filter by intent, spot patterns in the heatmap, and track your competitive rankings by topic.
## Organic mention rate
The subtitle of the Prompts page shows your **organic mention rate** — the percentage of non-branded queries (those that do not include your brand name) where your brand appears in the AI response. This is the headline signal for true AI discoverability. A prompt is classified as branded if its text contains your brand name; all other prompts contribute to the organic rate.
***
## Managing prompts
### Adding prompts
Click **Add Prompts** in the top-right corner of the All Prompts tab.
Type prompts manually, paste a list, or use the AI generator to suggest prompts based on your brand and topics. Each prompt can have a topic, an intent, and a persona tag assigned at creation time.
Click **Add** to save the prompts. New prompts enter the analysis queue and results typically appear within 15–30 minutes.
### Editing a prompt
Click the edit icon (pencil) on any prompt row to update its text, topic assignment, or intent classification. Edits take effect on the next analysis run.
### Deleting a prompt
Click the delete icon on a prompt row to remove it. You will see a confirmation before the deletion is finalized. To remove multiple prompts at once, select them with the checkboxes and use the bulk delete action.
### Importing prompts
The Add Prompts dialog also accepts a bulk import. Paste a newline-separated list of prompt texts or upload a CSV with a `text` column. You can assign a topic and intent to all imported prompts at once.
***
## Filtering prompts
The All Prompts tab includes four filters you can combine to narrow the prompt list.
Filter to **Branded** (prompt text contains your brand name), **Non-branded**, or **Any**. Non-branded prompts are the ones that drive your organic mention rate.
Filter by query intent: **Informational**, **Commercial**, **Transactional**, or **Navigational**. Intent is assigned when you add a prompt and can be changed at any time.
Filter to **Appearing in responses** (brand mentioned in ≥ 50% of analyses) or **Not appearing** to quickly find prompts where you have low visibility.
If you have defined personas, filter to prompts tagged with a specific persona or show only untagged prompts. Persona tags group prompts by the customer segment they represent.
Click **Clear all** to reset all active filters at once.
***
## Bulk actions
Select prompts using the checkboxes, then use the bulk action bar to:
* **Delete** — permanently remove the selected prompts (requires confirmation)
* **Assign topic** — move all selected prompts to a topic or remove their topic assignment
* **Assign persona** — tag or untag all selected prompts with a persona
Bulk actions apply only to the prompts visible on the current page after filtering. Prompts hidden by an active filter are skipped.
***
## Tabs
The main list of your prompts, organized by topic. Each topic section shows its prompts along with a coverage percentage — the share of analyzed prompts where your brand was mentioned. Expand a topic to see individual prompts and their starred status.
Use the search box to filter by prompt text or topic name. The **Export CSV** button downloads the full visible prompt list (after all active filters are applied) including prompt text, creation date, activity status, and last analysis timestamp.
Starring a prompt (click the star icon) moves it to the top of its topic section so you can keep your highest-priority queries visible without filtering.
The Responses tab shows every raw AI response Pharos has collected. Each row includes the prompt text, the AI platform that answered it, whether your brand was mentioned, and the analyzed timestamp.
Use the column headers to sort by date, provider, or mention status. Additional filters let you narrow by:
* **Provider** — filter to a specific AI platform
* **Mentioned** — show only responses where your brand was or was not mentioned
* **Date range** — limit to a specific time window
* **Branded / non-branded** — scope to branded or organic queries
Click any response row to open the full response text and see the competitor mention data extracted from that response.
If you navigate here from a heatmap cell, the Responses tab opens pre-filtered to that topic and competitor combination so you can read the underlying evidence.
The Heatmap tab visualizes your brand visibility across a grid of topics (rows) and competitors (columns). Each cell shows a visibility score — how often your brand appeared relative to that competitor for that topic. Darker cells indicate higher visibility.
Topics with insufficient data are excluded from the heatmap to avoid misleading scores from small samples. You can scope the heatmap to a specific persona using the persona selector above the tab bar.
Click any cell to jump to the Responses tab pre-filtered to that topic and competitor combination.
The heatmap populates after at least one analysis run has completed on prompts that have topics assigned. Prompts without a topic are excluded.
The Rankings tab shows how your brand ranks against competitors, topic by topic. For each topic, Pharos lists every brand that was mentioned in responses, ordered by visibility score for that topic.
Use the persona selector to scope rankings to a specific customer persona. Rankings are only shown for topics with enough analyzed responses across providers to produce stable scores.
Use Rankings to prioritize content investments: topics where competitors rank well above you but have high commercial intent are typically the best places to focus.
***
## Prompt detail
Click any prompt text to open the prompt detail view. This shows:
* The full prompt text and its metadata (topic, intent, persona)
* A timeline of all analysis runs for that prompt
* Per-provider mention rates (how often each AI platform mentions your brand for this prompt)
* Competitor mentions extracted from the responses
From the detail view you can edit the prompt, star it, or delete it.
***
## Export
Click **Export CSV** on the All Prompts tab to download the filtered prompt list. The CSV includes:
| Column | Description |
| ----------------- | ------------------------------------------------- |
| Text | The prompt text |
| Created at | When the prompt was added |
| Active | Whether the prompt is currently active |
| Generation method | Manual, imported, or AI-generated |
| Last analyzed at | When the most recent analysis ran for this prompt |