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

# Prompts & topics

> Create, organize and run the prompts Cliro tracks across AI models — with topics, tags, AI suggestions and on-demand execution.

**Prompts** are the questions Cliro asks the AI models. The **Prompts** page is where you manage them, grouped into **topics** and refined with **tags**.

## How prompts are organized

* **Topics** group related prompts (e.g. "pricing comparisons"). Use the sidebar to switch between **All prompts** and a specific topic, or **Add topic**.
* **Tags** are labels you attach to prompts to filter your data later — by funnel stage, campaign or region.
* **Location** scopes a prompt to a market so answers reflect that audience.

## Add a prompt

<Steps>
  <Step title="Open Add prompt">
    Click **Add prompt**. Write a natural question — the way a real person would ask an AI.
  </Step>

  <Step title="Assign a topic and tags">
    Choose a topic (or leave it untopiced) and optionally add tags.
  </Step>

  <Step title="Set the location">
    Pick the market the prompt should target.
  </Step>

  <Step title="Save">
    The prompt is created as **active** and scheduled to run shortly.
  </Step>
</Steps>

<Tip>
  Write **competitive** prompts that don't name your own brand — e.g. *"What is the best insurance?"* rather than *"Is \[your brand] good?"*. That's how you measure whether AI surfaces you organically. You can enter multiple prompts at once by putting each on its own line.
</Tip>

## Generate prompts with AI

Click **Generate with AI** to have Cliro suggest prompts based on your topics and brand. Suggested prompts appear for review and **don't count toward your plan limit until you activate them**.

## Bulk import

Use **Bulk upload** to import many prompts from a spreadsheet:

<Steps>
  <Step title="Download the template">
    The Excel template includes the required columns plus dropdowns for country, topic and tag.
  </Step>

  <Step title="Fill it in">
    Add one prompt per row.
  </Step>

  <Step title="Upload the .xlsx file">
    Cliro imports the prompts and shows a result summary — rows processed, prompts created, and any rows with errors.
  </Step>
</Steps>

## Activate, deactivate and delete

| Action         | Effect                                                                                         |
| -------------- | ---------------------------------------------------------------------------------------------- |
| **Activate**   | Starts tracking the prompt. It counts toward your prompt limit and runs on the daily schedule. |
| **Deactivate** | Stops tracking and frees up the slot. Existing data is kept.                                   |
| **Delete**     | Removes the prompt. If it was active, the slot is freed.                                       |

<Note>
  Your plan has a limit on **active** prompts. Suggested and inactive prompts don't count. When activating several at once, Cliro validates the whole batch against your limit — it's all-or-nothing.
</Note>

## Run a prompt now

Use **Execute now** to run a prompt immediately instead of waiting for the daily cycle — handy after editing a prompt or to check a fresh result. Active prompts also re-run automatically every day.

## The prompt detail view

Click any prompt to open its detail page, where you can see, per model:

* The full **response** the model gave.
* Whether (and where) your brand was **mentioned**.
* **Sentiment** and **position** for each mention.
* The **citations** the model used.

Columns in the prompts table include **Visibility**, **Sentiment**, **Position**, **Mentions**, **Topic**, **Tags** and **Location**, and can be filtered by date, model, topic, tag and country. Use **Export** to download the table.

## Next

<CardGroup cols={2}>
  <Card title="Citations" icon="quote" href="/en/visibility/citations">
    The sources behind the answers.
  </Card>

  <Card title="Tags" icon="tag" href="/en/knowledge-base/tags">
    Organize prompts for sharper reporting.
  </Card>
</CardGroup>