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

# Tutorial: Manage prompts

> Read the prompts page, accept suggestions, and organize by topic.

Curate the prompts Topify tracks for your brand. You'll first learn how to read the prompts page, then accept suggestions and inspect a prompt's analytics.

<Info>
  **Prerequisites**: A project with bootstrapping complete. If you don't have one yet, follow [Tutorial: Set up your first project](/quickstart).
</Info>

## Where prompts live

Navigate to **Tracking > Prompts** in the sidebar.

<Frame caption="The prompts page with topic groups, the Active / Suggested tabs, and per-prompt metrics.">
  <img src="https://mintcdn.com/topifyai-2f023d9f/UdujGxTCLDqIkdDg/tutorials/manage-prompts/prompts-all.png?fit=max&auto=format&n=UdujGxTCLDqIkdDg&q=85&s=19a9d3f863b787c4de2700ae2d5bbe73" alt="Prompts page with Active / Suggested tabs, date range and model filters, search box, Add Prompts button, and a table grouping prompts by topic with AI Volume, Visibility, and Sentiment columns." width="2141" height="1290" data-path="tutorials/manage-prompts/prompts-all.png" />
</Frame>

## What you see on this page

The page has several sections — understanding each makes the rest of the tutorial click.

### Tabs

* **Active** -- prompts that Topify sends to AI providers daily and tracks.
* **Suggested** -- AI-drafted prompts waiting for your decision. Promote them to Active or reject them.

### Filter bar

The bar above the table controls the metric columns on the right:

* **Date range** -- the period that Visibility, Sentiment, and the trend deltas are calculated over.
* **All Models** -- which AI providers (ChatGPT, Perplexity, Google AI Overview) are included. Switching narrows the metrics to just that provider.
* **Search prompt** -- text search across prompt content.
* **+ Add Prompts** -- add a custom prompt or import from research. See [Managing prompts](/guides/managing-prompts).

### Topic groups

Prompts are grouped by topic. Each topic header shows the topic name and the prompt count (e.g. *AI Search Visibility Tools — 3 prompts*).

* Click the **chevron** on the left of a topic row to expand or collapse it.
* Click the **topic row itself** to select every prompt under that topic — useful for bulk actions like untracking a whole topic at once.

### Columns

The table shows AI Volume, Visibility, and Sentiment for each prompt, with green/red deltas comparing the selected period to the prior one. For full definitions of every metric, see [Brand metrics](/concepts/brand-metrics).

## Steps

<Steps>
  <Step title="Accept a suggested prompt">
    Switch to the **Suggested** tab.

    <Frame caption="The Suggested tab.">
      <img src="https://mintcdn.com/topifyai-2f023d9f/UdujGxTCLDqIkdDg/tutorials/manage-prompts/prompts-suggest.png?fit=max&auto=format&n=UdujGxTCLDqIkdDg&q=85&s=2e860d61c8a750a0c9a675895ddc0d36" alt="Suggested tab on the prompts page." width="2139" height="1284" data-path="tutorials/manage-prompts/prompts-suggest.png" />
    </Frame>

    The **type** column on the right tags each suggestion as either:

    * **Suggested** -- generated from your brand context.
    * **URL** -- generated from the [From research](/guides/managing-prompts#from-research) flow. This takes a URL (your blog post, landing page, or any sub-page of your site) and drafts prompts targeting that page so you can track how AI assistants surface it.

    Click the refresh button to refresh the list. Use the checkboxes and the bulk action bar at the bottom to **Track** (promote to Active) or **Reject** (remove from the list).
  </Step>

  <Step title="Inspect a prompt's analytics">
    Click any active prompt to open its detail page.

    <Frame caption="The prompt detail page.">
      <img src="https://mintcdn.com/topifyai-2f023d9f/UdujGxTCLDqIkdDg/tutorials/manage-prompts/prompts-detail.png?fit=max&auto=format&n=UdujGxTCLDqIkdDg&q=85&s=51c863798a6c63bc63d14581b9aaa9e4" alt="Prompt detail page." width="2151" height="1285" data-path="tutorials/manage-prompts/prompts-detail.png" />
    </Frame>

    From here you can see:

    * Per-provider metrics (visibility, sentiment, position)
    * Cited domains and URLs
    * The actual AI responses that were collected

    Drill into a domain to see every response that cited it.
  </Step>
</Steps>

## What's next

<Columns cols={2}>
  <Card title="Tutorial: Generate articles" icon="pen-to-square" href="/tutorials/generate-articles">
    Use prompts as input for AI-optimized article generation.
  </Card>

  <Card title="Use the AI agent" icon="robot" href="/guides/using-ai-agent">
    Let the agent suggest prompt edits and topic restructures.
  </Card>
</Columns>

## FAQ

### What makes a prompt "good"?

A good prompt is something a real buyer would actually type into ChatGPT or Perplexity — usually a question rather than a keyword string ("what's the best CRM for a 5-person sales team?" rather than "best CRM small team"). Mix intent types (informational, comparison, transactional) so you cover the full buyer journey, not just the bottom of the funnel.

### Can I edit a prompt after activating it?

Editing the prompt text would change what we send to AI providers daily and break trend continuity for that prompt, so we don't allow it. Instead, **untrack** the prompt you want to change and **add** a new version. Historical data on the old prompt is preserved.
