Prompts

​

Purpose

The Prompts page is the central workspace for managing the questions and searches Athena tracks on your behalf across AI engines. It serves as your command center for organizing prompts into topics, configuring how and where they are run, and tracking their overall performance over time. From here, you can group prompts into topical clusters, review critical metrics like Share of Voice and mention rates, set geographic and persona targeting, and explore new prompt ideas. It is an essential part of the workflow for marketers monitoring their brand’s visibility in AI search.

​

What’s on the page

​

Page Header

The top header displays the “Prompts” title alongside an info icon that launches a guided product tour. Next to it is a tab menu to navigate between Manage (the main table), Personas, Locations, and Discover. In the top right, an Add More button provides options to add new prompts, topics, locations, or tags.

​

Prompts Table (Manage Tab)

The main content area is a spreadsheet-style table grouping your tracked prompts by topic. Columns:

• Select (checkbox): Selects individual rows. Clicking the checkbox on a topic row selects all prompts within that topic.
• Base Prompt: The text of the tracked prompt. May include a “Paused” badge if the prompt is currently paused, and a “View responses” button to quickly see the AI answers.
• Countries: Flags representing the countries where the prompt is configured to run. Clicking this opens a country editor.
• Mention Gap: Your brand’s mention percentage minus your competitor’s mention percentage. Tooltip: “Mention % - Competitor Mention %”
• Citation %: Tooltip: “Percentage of responses that include a citation to your brand”
• Competitor Citation %: Tooltip: “Percentage of responses that include a competitor citation”
• Citation Gap: Your citation percentage minus your competitor’s citation percentage. Tooltip: “Citation % - Competitor Citation %”
• Attributed Citation %: Tooltip: “Citations from content you created in Action Center”
• Mention %: Tooltip: “Percentage of responses that mention your brand”
• Competitor Mention %: Tooltip: “Percentage of responses that mention a competitor”
• Est. Impressions: Tooltip: “Estimated number of times your brand appears in AI responses (Monthly Queries × Mention %)”
• Avg position: Tooltip: “Average ranking position in AI responses (lower is better)”
• Variations: Tooltip: “Number of unique prompt variations”
• Monthly queries: Tooltip: “Estimated monthly search queries”
• Value: Tooltip: “Total estimated value of queries”
• Est. value captured: Tooltip: “Estimated value captured based on mention % and total value”
• Tags: Tags assigned to the prompt.
• Prompts: Number of prompts in the topic group.
• Manage (⋯): A menu for actions you can take on that specific row.

​

”Prompt analytics” side panel

Clicking on a prompt row opens a persistent side panel titled Prompt analytics. It displays a mini-dashboard of visibility metrics scoped entirely to that prompt (or topic group, if a topic row is clicked). For a single prompt, the panel also includes a Prompt Variations table with the following columns:

• Type: Indicates whether the text is the “Base Prompt” or a “Variation” generated by the AI engines.
• Prompt text: The literal text of the base prompt or variation.

​

”Uncategorized prompts” bar

A fixed bar that appears at the bottom of the screen if you have active prompts that have not been assigned a topic. It shows the number of uncategorized prompts and gives you quick options to handle them.

​

Bulk-selection bar

A fixed bar that slides up from the bottom of the screen whenever you select one or more rows using the table checkboxes. It provides actions that apply to all selected items.

​

What you can do here

​

Navigation and top-level actions

• Switch tabs: Navigate to Personas, Locations, or Discover by clicking the tabs in the top header.
• Add items: Click the Add More button to open the “Add Prompts” flow, create an “Add Topic” entry, “Add Location”, or “Add Tag”.
• Change visible columns: Click the Columns option (under the ⋯ menu in the filter bar) to customize which metrics appear in your table.
• Export data: Click Export as CSV in the top filter bar’s ⋯ menu to download a spreadsheet of the currently visible prompts.

​

Row-level actions

Click the ⋯ (More options) menu on any prompt row to access:

• Edit: Opens the Edit Prompt panel to change the prompt text (only if it has zero tracked responses), update the topic, apply tags, and select running countries. This panel will also show estimated monthly credit changes before saving.
• Refresh Volume: Manually recalculates the search volume and value for this prompt.
• Pause / Unpause: Halts or resumes data collection for the prompt.
• Delete: Opens the Delete Prompt dialog to permanently remove it.

Click the ⋯ (More options) menu on a topic group row to access:

• Edit Topic: Opens the Edit Topic dialog to rename the topic or update its description.
• Delete Topic: Opens the Delete Topic dialog. You will be asked whether you want to “Delete Prompts Only” (which deletes the prompts but keeps the empty topic) or “Delete Topic & Prompts” (which permanently destroys both).

​

Reorganize prompts

• Drag and drop: Click and hold the grab handle (six dots) on any prompt row to drag it into a different topic, or to reorder it within its current topic.

​

Categorize new prompts

If the Uncategorized prompts bar is visible at the bottom of the screen, you can:

• View prompts: Opens a list of the prompts waiting to be filed.
• Categorize: Uses AI to automatically sort all uncategorized prompts into relevant topics.
• Dismiss (Esc): Hides the bar.

​

Bulk actions

Select multiple rows using the checkboxes to reveal the bulk action bar. You can:

• Stream Data: Immediately queues a fresh data run for the selected prompts.
• Write Content: Opens the content-drafting flow pre-populated with these prompts (maximum of 100).
• Pause / Unpause: Halts or resumes tracking for all selected prompts.
• Delete: Opens the bulk deletion dialog.
• Reset (Esc): Clears your row selection.
• Open the M (More) menu on the bulk bar to access:
  • Tags: Bulk-assign tags via the “Edit prompt tags” dialog.
  • Locations: Bulk-assign local tracking areas.
  • Countries: Bulk-assign tracking countries via the “Edit Countries” dialog.
  • Assign topic: Move all selected items into a single topic.
  • Refresh volume: Request updated search volume calculations.
  • View in Olympus / View in Brand Visibility: Jumps to the analytics dashboard pre-filtered to show only your selected prompts.
  • Create view: Saves the selected prompts as a custom, reusable Saved View.
  • Export as CSV: Downloads the selected items to a spreadsheet.

​

Data shown

The table merges your configured prompts with ongoing performance metrics drawn directly from AI engines (like ChatGPT, Claude, and Perplexity). Search volume estimates come from historical search engine keyword data. Comparisons (such as Mention Gap and Citation Gap) directly contrast your brand’s presence against the competitors you configured for your website.

​

Common workflows

Categorizing a newly imported batch of prompts:

1. After a CSV import or bulk AI generation, look for the Uncategorized prompts bar at the bottom of the screen.
2. Click View prompts to review what hasn’t been filed.
3. Click Categorize to automatically assign them to existing topics (or generate new topics for them).

Reviewing performance changes over time:

1. Open the Date range filter at the top and ensure a comparison period is active.
2. Look at the Mention Gap and Citation Gap columns to see if you are gaining ground on competitors.
3. Click on a specific prompt row that interests you to open the Prompt analytics side panel and view its Share of Voice over time.

Moving prompts in bulk:

1. Select the checkboxes next to multiple prompts (or select an entire topic using the group checkbox).
2. In the bulk action bar that appears, click the M (More) button.
3. Select Assign topic, pick the destination topic from the dropdown, and confirm.

​

Empty, loading, and error states

• Empty: If you have no data yet, metric columns will display “No data yet”. If a topic is entirely empty, it will show as a placeholder row containing “(0)” (unless you have active text/tag filters, in which case empty topics are hidden).
• Loading: When first loading the page, you’ll see a large animated spinner. While metrics are being calculated in the background, individual cells will show a brief skeleton shimmer effect.
• Errors: If an action fails (like moving a prompt, editing a tag, or running categorization), a red toast notification will appear in the corner explaining the failure (e.g., “Failed to update prompt”).

​

Linked from / links to

• Linked from: The main sidebar navigation, the post-onboarding completion screen, guided product tour links, and saved bookmarks for legacy prompt tabs.
• Links to: The Responses page (via “View responses” buttons), the full Analytics dashboard (via “View in Olympus”), and the other inner tabs (Personas, Locations, Discover).

​

Common support questions

Why can’t I edit my prompt’s text? Once a prompt has been run and collected AI responses, its base text is locked. This ensures your historical visibility metrics remain accurate to the exact text that was run. If you need a completely different prompt, you should pause the old one and create a new one. What does “No data yet” mean in my table? Your prompts have been saved and scheduled to run, but no AI responses have been collected and analyzed for the specific date range you have selected in your filters. How do I download this list? Click the ⋯ menu in the top filter bar, or select specific rows and click Export as CSV in the bulk action bar. Note that CSV exports may prompt an upgrade dialog if you are on a Free plan.