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

# Prompts Report

> Analyse how each prompt performs across AI services with visibility scores and brand data.

The **Prompts** tab shows all your tracked prompts with performance data, helping you understand which questions drive visibility and which need attention.

## The Prompts Table

| Column               | Shows                                                     |
| -------------------- | --------------------------------------------------------- |
| Topic / Prompt       | Topic rows in grouped view, or question text in list view |
| Visibility           | Your brand's visibility score for the topic or prompt     |
| Avg. Position        | Your brand's average position when it is mentioned        |
| Top Brands           | Up to 5 most-mentioned brands                             |
| Country              | Geographic context with flag                              |
| Estimated Popularity | Relative search volume (5-dot scale)                      |
| Tags                 | Labels you've assigned                                    |

## Grouped By Topic

By default, the Prompts table opens in **Group by Topic** view. Topic rows summarise the prompts in that topic, including overall visibility, average position, and the top brands for the topic. Expand a topic to see the prompt rows beneath it using the same columns.

## Visibility Score

Shows the percentage of AI responses that mention your selected brand for each prompt. Requires a **brand** and **date range** to be selected in the filter bar.

You can sort by visibility (click the column header) to find your strongest and weakest prompts.

## Estimated Popularity

A 5-dot indicator showing the relative search intent behind each prompt within your project.

### How it works

For each prompt, we derive a keyword that matches the underlying intent which represents a traditional web search query. We then use partner data vendors to retrieve the search volume for that keyword in the relevant country, providing a proxy for how much real-world demand exists behind the prompt.

This traditional search volume is mapped to a 5-point scale relative to the other prompts in your project:

| Dots | Level     |
| ---- | --------- |
| 1    | Minimal   |
| 2    | Low       |
| 3    | Medium    |
| 4    | High      |
| 5    | Very High |

Hover for exact search volume. Popularity is relative to other prompts in your project.

:::note
Estimated Popularity is a **directional** data point — it helps you compare the relative importance of prompts within your project rather than providing an absolute measure. The "estimated" caveat reflects that search intent is used as a proxy for prompt popularity, which is imperfect but useful for prioritising which prompts matter most.
:::

## Filters

Beyond the global filter bar (Brand, Date Range, Topics, Tags, Services, Geos), the Prompts table adds:

* **Search** - Find prompts by keyword or text
* **Visibility Range** - Filter by minimum and/or maximum visibility percentage

## Bulk Actions

Select multiple prompts using the checkboxes, then choose an action:

| Action           | What it does                                          |
| ---------------- | ----------------------------------------------------- |
| Add Tags         | Append tags to selected prompts (keeps existing tags) |
| Replace All Tags | Replace all tags on selected prompts with new ones    |
| Remove All Tags  | Clear all tags from selected prompts                  |
| Change Topic     | Assign or change the topic for selected prompts       |
| Delete Selected  | Permanently delete selected prompts                   |

## Inline Tag Editing

Hover over the tags column on any row to reveal an edit icon. Click it to add or change tags for that individual prompt.

## Export

Click **Export** to download all prompts with their visibility data as an Excel file. Current search and filter settings are applied to the export.

## Tips

* Sort by visibility descending to find prompts where you're already strong
* Sort ascending to find prompts where competitors dominate and you need to improve
* Use the visibility range filter to quickly find prompts below a threshold (e.g., under 30%)
* Click a prompt to jump to the dashboard filtered to that specific question
* Organise prompts into topics and use tags for additional dimensions — both power the Matrix view

<Warning>
  Deleting prompts removes all their historical data and cannot be undone.
</Warning>