> ## Documentation Index > Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Prompts > Manage, discover, and organize the prompts (plus personas, locations, and discovery) that Athena runs against AI models to track brand visibility `app.athenahq.ai/prompts` ## Purpose The Prompts page is the central hub for managing, discovering, and organizing the exact questions and statements (prompts) that Athena runs against AI models to track your brand's visibility. It allows customers to structure their AI tracking strategy by grouping prompts into logical Topics, assigning them to target Personas, and running them across specific geographic Locations. Customers use this page to evaluate how often they are mentioned or cited for specific high-value searches, compare their performance to competitors, discover new prompt ideas, and take bulk actions to clean up or categorize their tracking setup. ## What's on the page **Page header / tab bar** The top of the page includes the "Prompts" title with an info tooltip that launches a guided walkthrough tour. Next to it is a tab strip to navigate between **Manage**, **Personas**, **Locations**, and **Discover**. If a customer's subscription plan does not include access to Personas, Locations, or Discover features, those tabs will display a small lock icon. **Filter bar** A row of controls below the tabs. This includes a search bar, a date range picker, model selections, and a "More Filters" dropdown. It also houses saved views and the "Add More" menu for creating new items. **Manage tab (prompts table)** The default view. A spreadsheet-style table that lists every tracked prompt, grouped by Topic. It displays AI-visibility metrics alongside each prompt, supports drag-and-drop reorganization, and offers row-level and bulk actions. **Categorize Uncategorized command bar** A sticky banner that appears at the bottom of the screen if the customer has prompts that aren't assigned to any topic. It prompts the user to let AI automatically categorize them. **Bulk selection command bar** A sticky bottom bar that appears the moment a customer selects one or more checkboxes in the table. It replaces the Categorize bar and provides tools to act on many prompts at once. **Prompt Analytics drawer** A slide-in panel that opens when you click on a prompt or a topic. It provides a mini analytics dashboard containing share of voice, mention/citation rates, position over time, and brand traits. For single prompts, it also displays a **Prompt Variations table**. **Edit Prompt drawer** A form to edit a single prompt's configurations, including its text, tags, assigned countries and locations, volume, and topic. It also includes an option to pause the prompt and shows an estimate of how the changes will impact the customer's credit usage. **Delete confirmation dialog** A warning modal that appears before deleting selected prompts or topics. It offers choices between deleting just the prompts or deleting the topic entirely. **Edit Topic dialog** A simple form to rename a topic and update its description. **Personas tab** A feature-gated table focusing on the customer's configured buyer personas and the specific prompts and metrics associated with each. **Locations tab** A feature-gated table that provides a hierarchical view of visibility metrics broken down by Country → Location → Topic → Prompt. **Discover tab** A feature-gated, lazy-loaded tab for prompt discovery: run scans across sources like website analysis, Search Console, social, and keyword gaps, then review and track the suggested prompts. It replaces the earlier Planner and Universe tabs, and old links to those redirect here. ### Prompts table (Manage tab) Lists every prompt grouped by topic with per-prompt AI-visibility metrics. * **Select**: Row/topic checkbox for bulk actions, supports shift-click range select. * **Topic**: Hidden accessor column used only for grouping rows by topic. * **Base Prompt**: The prompt text; shows a Paused badge if paused, a 'View responses' hover button, and topic prompt-count when grouped. * **Countries**: Flags of countries this prompt runs in; click opens per-prompt country editor. * **Mention Gap**: Your mention % minus competitor mention %. (Tooltip: *Mention % - Competitor Mention %*) * **Citation %**: Percentage of responses that include a citation to your brand. (Tooltip: *Percentage of responses that include a citation to your brand*) * **Competitor Citation %**: Percentage of responses that include a competitor citation. (Tooltip: *Percentage of responses that include a competitor citation*) * **Citation Gap**: Your citation % minus competitor citation %. (Tooltip: *Citation % - Competitor Citation %*) * **Attributed Citation %**: Citations from content you created in Action Center. (Tooltip: *Citations from content you created in Action Center*) * **Mention %**: Percentage of responses that mention your brand. (Tooltip: *Percentage of responses that mention your brand*) * **Competitor Mention %**: Percentage of responses that mention a competitor. (Tooltip: *Percentage of responses that mention a competitor*) * **Est. Impressions**: Estimated number of times your brand appears in AI responses (Monthly Queries × Mention %). (Tooltip: *Estimated number of times your brand appears in AI responses (Monthly Queries × Mention %)*) * **Manage (actions)**: Kebab menu with Edit, Refresh Volume, Pause/Unpause, Delete, etc. ### Prompt Variations table (in Analytics drawer) Lists a single prompt's base text and all detected variations/fan-outs. * **Type**: 'Base Prompt' or 'Variation' badge. * **Prompt text**: The literal prompt/variation text. ### Locations table (Locations tab) Hierarchical (country → location → topic → prompt) list of geo-scoped visibility metrics. * **Select**: Row checkbox for bulk delete. * **Location**: Country/location/topic/prompt name with expand/collapse chevrons. * **Mention %**: Percentage of responses that mention your brand. (Tooltip: *Percentage of responses that mention your brand*) * **Competitor Mention %**: Percentage of responses that mention a competitor. (Tooltip: *Percentage of responses that mention a competitor*) * **Sentiment %**: Percentage of positive sentiment in AI responses. (Tooltip: *Percentage of positive sentiment in AI responses*) * **Mention gap**: Difference between your mention % and competitor mention %. (Tooltip: *Difference between your mention % and competitor mention %*) * **Citation %**: Percentage of responses that cite your website. (Tooltip: *Percentage of responses that cite your website*) * **Competitor Citation %**: Percentage of responses that cite a competitor website. (Tooltip: *Percentage of responses that cite a competitor website*) * **Citation gap**: Difference between your citation % and competitor citation %. (Tooltip: *Difference between your citation % and competitor citation %*) * **Attributed Citation %**: Percentage of responses with attributed citations to your website. (Tooltip: *Percentage of responses with attributed citations to your website*) * **Avg position**: Average ranking position in AI responses (lower is better). (Tooltip: *Average ranking position in AI responses (lower is better)*) * **Variations**: Number of unique prompt variations. (Tooltip: *Number of unique prompt variations*) * **Monthly queries**: Estimated monthly search queries. (Tooltip: *Estimated monthly search queries*) * **Value**: Total estimated value of queries. (Tooltip: *Total estimated value of queries*) * **Impressions**: Estimated monthly impressions based on mention % and monthly queries. (Tooltip: *Estimated monthly impressions based on mention % and monthly queries*) * **Est. value captured**: Estimated value captured based on mention % and total value. (Tooltip: *Estimated value captured based on mention % and total value*) * **Tags**: Prompt tags aggregated for the location. * **Manage (actions)**: Kebab menu of location actions (edit, delete, etc.). ## What you can do here **Top-level actions** * **Start guided tour (Info icon)**: Opens the Prompts page walkthrough tour. * **Switch tab: Manage / Personas / Locations / Discover**: Updates the `?tab=` URL param and swaps the visible content area. * **Add More → Add Prompts**: Opens Add Prompt drawer (AI-suggested or CSV import). * **Add More → Add Topic**: Opens Add Topic dialog to create a new topic. * **Add More → Add Location**: Opens Add Location drawer (only if location offering enabled). * **Add More → Add Tag**: Opens the Prompt Tags drawer in create mode. * **More options (⋯) → Columns**: Opens the column visibility/reorder popover. * **More options (⋯) → Export**: Downloads visible/selected prompts as CSV (gated behind data-export plan check). **Row and Topic actions** * **Click a prompt row**: Opens the Prompt Analytics drawer for that single prompt and syncs `?promptId=` in URL. * **Click a topic group header**: Opens the Prompt Analytics drawer scoped to all prompts in that topic. * **'View responses' button on a prompt row**: Navigates to `/responses` filtered to that prompt. * **Row action menu → Edit**: Opens Edit Prompt drawer for that prompt. * **Row action menu → Refresh Volume**: Recalculates and refreshes that prompt's search volume/value. * **Row action menu → Pause/Unpause**: Toggles whether the prompt is actively scheduled/run. (No confirmation needed; immediate toggle with toast). * **Row action menu → Delete**: Opens Delete confirmation dialog for that prompt. (Destructive). * **Drag a prompt onto a topic / another prompt**: Reassigns the prompt's topic and/or reorders it within the topic. * **Topic row menu → Edit topic**: Opens Edit Topic dialog. * **Topic row menu → Delete topic**: Opens Delete dialog offering to delete just prompts or topic+prompts. (Destructive). **Categorize Uncategorized bar** * **Categorize**: Runs AI categorization to assign topics to uncategorized prompts. * **Dismiss**: Hides the uncategorized-prompts bar until more are added. **Bulk bar (appears when rows are selected)** * **Stream Data**: Opens the **Schedule** dialog scoped to the selected prompts. * **Pause/Unpause**: Opens a confirmation dialog for the selection. * **More → Tags**: Opens the **Edit Tags** dialog. * **More → Countries**: Opens the **Edit Countries** dialog. * **More → Assign topic**: Opens the **Move to Topic** dialog. * **More → Refresh volume**: Opens confirm dialog then triggers background bulk volume/value refresh (enterprise-gated). * **More → View in Olympus / Brand Visibility**: Applies selected prompts as a filter and navigates to `/olympus`. * **More → Create view**: Opens Create View From Selection dialog to save current selection as a saved view. * **More → Export**: Downloads selected prompts as CSV. * **Delete**: Opens Delete dialog for selected prompts/topics. (Destructive). * **Reset**: Clears row selection. **Dialog actions** * **Delete dialog → Delete Prompts Only**: Soft-deletes selected prompts (undoable) and keeps their topics. (Destructive). * **Delete dialog → Delete Topic & Prompts**: Deletes the topic(s) and all their prompts. (Destructive. Cannot be undone for topics). * **Undo (toast after prompt delete)**: Restores the soft-deleted prompts (chunked in batches of 1000). * **Edit Prompt drawer → Pause/Unpause**: Toggles pause state of the prompt being edited. * **Edit Prompt drawer → Save changes**: Persists prompt text/type/topic/countries/locations changes, shows credit delta. * **Edit Prompt drawer → Tags field**: Opens Edit Prompt Tags dialog. * **Edit Topic dialog → Save Changes**: Renames topic and updates its description. * **Prompt Analytics drawer → close**: Closes drawer and clears `?promptId=` param. ## Data shown This page displays the prompts you have actively configured to track how your brand appears in AI search engines. The metrics shown (like mention percentages, sentiment, and citation gaps) are derived directly from the recent responses collected from major AI models (like ChatGPT, Claude, Gemini, etc.). Search volume and impression data are gathered from search analytics tools integrated with your account to give an estimate of how valuable each prompt's visibility is. ## Common workflows **Organizing prompts into topics** 1. Locate a prompt you want to move. 2. Click and hold the drag handle (grip icon) on the row. 3. Drag the prompt over to the desired Topic header and release it to reassign it. 4. Alternatively, use the checkboxes to select multiple prompts, then click **More → Assign topic** in the bulk bar at the bottom to move them all at once. **Investigating a prompt's performance** 1. Click anywhere on a prompt's row (outside of the checkbox or actions menu) to slide open the Prompt Analytics drawer. 2. Review the mini-dashboard inside to see the prompt's share of voice and ranking over time. 3. Click **View responses** inside the drawer (or hover over the prompt text in the main table) to jump directly to the Responses page to read the exact AI outputs. **Deleting a topic** 1. Click the three-dot menu (⋯) on a Topic row header. 2. Select **Delete**. 3. In the confirmation dialog, choose whether you want to **Delete Prompts Only** (which keeps the topic but removes the tracking phrases) or **Delete Topic & Prompts** (which permanently removes the topic category itself). ## Empty, loading, and error states * **Empty**: For topics with zero prompts, an empty-topic placeholder row renders so the topic doesn't disappear (unless you have active narrowing filters applied). The Locations and Personas tabs will display their own "No data" states if nothing has been configured yet. * **Loading**: A blocking animated loader appears over the table while data is initially fetching. Individual metric columns will show a shimmering skeleton while calculating, turning into "No data yet" if a prompt simply hasn't gathered responses yet. * **Errors**: If an action fails (like moving a prompt or categorizing), a red error toast will appear (e.g., "Failed to move prompt" or "Failed to delete"). The Locations table will show a specific fetch-error state with a "Retry" button if it fails to load completely. ## Linked from / links to **Linked from:** * The main sidebar navigation. * Direct shortcuts to tabs (e.g., `/prompts?tab=personas` or `/prompts?tab=locations`). * Onboarding and guided tour deep links. * Legacy planner and universe links (which automatically redirect here). **Links to:** * `/responses` (when clicking to drill down into a prompt's exact AI answers). * `/olympus` (when selecting prompts and clicking "View in Olympus"). * `/prompts/discover/[id]` (when exploring the discovery tools). * `/settings/billing` (via plan upgrade gates if a customer tries to access a locked feature or export data on a free plan). ## Common support questions **Why can't I edit the text of my prompt?** Once a prompt has gathered AI responses, the text itself becomes locked and read-only. This prevents historical data from becoming mismatched against a newly edited phrase. If you need to track a different phrase, you should add it as a new prompt and pause or delete the old one. **Where did the "Categorize Uncategorized" bar go?** The categorize bar at the bottom of the screen shares the same space as the bulk selection bar. If you have any row checkboxes selected, the bulk action bar will override and hide the categorize bar. Click "Reset" or uncheck the rows to bring it back. **What happens if I delete a topic?** When you delete a topic, you'll be asked if you want to delete just the prompts inside it, or the topic *and* the prompts. If you choose to delete the topic itself, it is permanent and cannot be undone. If you delete prompts, you will get a brief "Undo" toast message to recover them if it was a mistake. **Why don't I see the "Refresh Volume" bulk action?** The ability to trigger a bulk refresh of search volume and value is restricted to Enterprise subscription plans. If you are on a different plan or accessing via an agency account, this option will be hidden. **I tried importing a large CSV of prompts and it failed, what do I do?** If you are importing a massive CSV (over 1,000 rows), the system processes it in chunks. If a chunk fails, the import stops to prevent errors. You'll need to refresh the page, check the prompt list to see which ones successfully imported, and try adding the remaining ones again.