> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anymorph.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompt

> Manage the prompts and topics that measure AI visibility, tracked as versioned panels

Prompt is the list of questions Anymorph actually sends to AI engines. Every number on [AI Visibility](/dashboard/visibility) comes from running this list, so changing the prompts changes what's being measured.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/opactor/images/dashboard/prompts-list.png" alt="Prompt list" />
</Frame>

## Structure

Prompts are grouped into two levels.

| Level       | Description                           | Example                                       |
| ----------- | ------------------------------------- | --------------------------------------------- |
| Topic group | A subject that groups related prompts | Sensitive skin care                           |
| Prompt      | The actual sentence sent to AI        | "Recommend a gentle toner for sensitive skin" |

[AI Visibility](/dashboard/visibility)'s per-topic mention rate is aggregated at this topic-group level.

## Reading the list

The default table is at the topic-group level; expand a row to see its prompts.

| Column       | Meaning                                                         |
| ------------ | --------------------------------------------------------------- |
| Topics       | The topic group's name and how many prompts it contains         |
| Mention rate | Share of this topic's responses that mentioned the brand        |
| Top Brands   | The brand mentioned most in this topic, including your own rank |
| Intent       | Informational, commercial, transactional, or navigational       |

Expanding a prompt row shows additional columns:

| Column            | Meaning                                          |
| ----------------- | ------------------------------------------------ |
| Prompts           | The actual sentence sent                         |
| Mentioned Engines | Engines that mentioned the brand for this prompt |
| Mentioned Brands  | Brands that showed up in the response            |

**Top Brands is the most practical column.** If mention rate isn't zero but you're ranked low in Top Brands, that topic still isn't secured.

### Intent

| Intent        | Nature                               | Content direction                   |
| ------------- | ------------------------------------ | ----------------------------------- |
| Informational | Asking about concepts or how-to      | Explainer guides                    |
| Commercial    | Comparing candidates                 | Comparison and alternative pages    |
| Transactional | Right before a purchase decision     | Price, configuration, purchase path |
| Navigational  | Looking for a specific brand or page | Official-info accuracy              |

## Filters and search

| Filter              | Use                                                   |
| ------------------- | ----------------------------------------------------- |
| Search              | Search topic or prompt text                           |
| Topic group         | Show only a specific group                            |
| Prompt scope        | Broad, specific, or niche                             |
| Unbranded / Branded | Split by whether the brand name appears in the prompt |
| Region              | Measured country                                      |
| Product             | Product-specific prompts                              |
| Language            | Measured language                                     |

<Tip>
  Check **Unbranded** first. A question that already names your brand is naturally easy to be mentioned in. Real new-customer touchpoints come from questions asked without a brand name, so that mention rate is your real scorecard.
</Tip>

## Topic detail

Click a topic row to open its detail view.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/opactor/images/dashboard/prompts-intent-detail.png" alt="Topic detail" />
</Frame>

| Section             | Content                                                      |
| ------------------- | ------------------------------------------------------------ |
| Overview            | Mention rate, response count, total volume, analysis date    |
| Fanout queries      | The sub-questions AI actually searched to answer this prompt |
| Top Brands          | Ranked brands mentioned for this topic                       |
| Seed keywords       | The search keywords this topic is built on                   |
| Mapped products     | Per-product mention rate, mention count, and sentiment       |
| AI response history | Actual responses by date and engine, with cited sources      |

### Fanout queries

AI engines don't search the prompt they're given verbatim. They break it into several smaller sub-questions, search those, and assemble the answer. Those sub-questions are the fanout queries.

| Column       | Meaning                                                        |
| ------------ | -------------------------------------------------------------- |
| Cluster      | The representative query for a group of similar queries        |
| Engines      | Engines that ran this query                                    |
| Times run    | Cumulative number of times this query ran across all responses |
| Cited you    | Whether you were cited in the results for this query           |
| SERP overlap | Share of Google's top 10 that AI also cited                    |

**A high SERP overlap means existing SEO already applies here.** A low one means AI is looking at different sources than Google, so you need [Off-Site](/dashboard/off-site) wins independent of your search ranking.

**The clusters where Cited you is "Not cited" are the highest-value targets.** AI is actually searching that question, and you're not in the answer.

## Editing prompts

| Task                 | How                                                         |
| -------------------- | ----------------------------------------------------------- |
| Add a prompt         | **New Prompt** inside a topic group                         |
| Edit a prompt        | Click the prompt text to edit it directly                   |
| Delete a prompt      | Delete from the row's menu                                  |
| Create a topic group | **New topic group**, set name, product, and language        |
| Edit a topic group   | **Edit Topic Groups**                                       |
| Export CSV           | **Download CSV**. Review or bulk-edit everything as a table |
| Import CSV           | **Import**. Choose between adding and replacing everything  |

<Warning>
  CSV import's **Replace all** deletes every existing topic and prompt. Always check the create/delete counts on the confirmation screen.
</Warning>

## Panel versions

The full prompt list is called a **panel**, and panels are versioned. This exists to keep a record of when and how what's being measured has changed.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/opactor/images/dashboard/prompts-panel-version.png" alt="Panel version bar" />
</Frame>

### How edits take effect

Not every edit reflects into measurement immediately.

| Edit type  | Criteria                                                                | When it takes effect        |
| ---------- | ----------------------------------------------------------------------- | --------------------------- |
| Minor edit | Typos and word order that don't change what's measured                  | Immediately                 |
| Major edit | Intent, language/country, brand/competitor mentions, or a large rewrite | **When you save a version** |

Major edits pile up as a draft, and **you have to save a version for it to reach the live panel.** The header's unpublished-changes indicator shows how many are waiting.

### Status

| Status   | Meaning                                    |
| -------- | ------------------------------------------ |
| Active   | The version currently used for measurement |
| Draft    | Changes not yet saved                      |
| Archived | A past version. Read-only, still viewable  |

### Configuration drift

If you add or delete prompts after saving a version, your current setup diverges from the active version. This is called **configuration drift**, and the count of changes is shown along with a prompt to save a new version.

### Viewing past versions

Selecting a past version from the version history shows that version's prompt snapshot and its linked responses, read-only. Your current panel stays untouched.

<Note>
  Responses recorded before version tracking was introduced aren't linked to any panel version. If a past version shows no responses, this may be why.
</Note>

### When to cut a new version

<Steps>
  <Step title="You've overhauled the topics">
    You added a new category or lineup and the measurement scope itself changed.
  </Step>

  <Step title="You changed the measured language or country">
    Same question, different market: results don't carry over.
  </Step>

  <Step title="You want a before/after comparison">
    Locking a baseline lets you read what follows as the effect of a specific change.
  </Step>
</Steps>

<Warning>
  Changing the panel breaks the trend line on [AI Visibility](/dashboard/visibility). Don't read across an overhaul as one continuous line. Use the panel-version filter on the visibility page to split it into segments.
</Warning>

## Principles for working with prompts

<AccordionGroup>
  <Accordion title="Match real questions over adding volume">
    Prompts should read like something a real user would type into an AI. A list of search keywords won't reliably draw out a real AI answer.
  </Accordion>

  <Accordion title="Include enough unbranded questions">
    Filling the panel only with branded questions produces a high mention rate that doesn't measure new-customer reach.
  </Accordion>

  <Accordion title="Don't mix intents inside one topic">
    Combining informational and purchase-intent questions in one topic makes the mention rate hard to interpret.
  </Accordion>

  <Accordion title="Don't change it too often">
    Frequent panel changes make trends unreadable. Set a regular review cadence and cut a version then.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="I edited a prompt but the visibility numbers didn't change">
    Major edits need a saved version. Check the unpublished-changes indicator in the header and save a version. It also takes the next analysis run to show up in the numbers after saving.
  </Accordion>

  <Accordion title="Saving a version is taking a while">
    A large panel can take up to about a minute. Don't close the window until the save finishes.
  </Accordion>

  <Accordion title="A conflict notice shows up while saving">
    Another edit landed first and conflicts with part of yours. Review the conflicting items and save again.
  </Accordion>

  <Accordion title="I imported a CSV and prompts disappeared">
    Choosing Replace on import deletes existing entries. If you saved a version before importing, you can find that configuration in the version history.
  </Accordion>

  <Accordion title="The list is empty">
    If you just onboarded, panel generation may still be in progress. It appears automatically once generation finishes.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="AI Visibility" icon="eye" href="/dashboard/visibility">
    See the results measured from these prompts.
  </Card>

  <Card title="Citation" icon="link" href="/dashboard/citation">
    See which sources AI uses as evidence.
  </Card>

  <Card title="Mentions" icon="comment-dots" href="/dashboard/mentions">
    Read the actual AI responses for a prompt.
  </Card>

  <Card title="On-Site" icon="file-lines" href="/dashboard/on-site">
    Build pages for the topics you haven't secured yet.
  </Card>
</CardGroup>
