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

# Prompts

> Write prompts that reflect how buyers ask AI engines, generate them or add them from fan-outs, a paste or a CSV file, organize them by topic and location, and stay within your plan's prompt pool.

> [!NOTE]
>
> **Plans:** All plans, [limits](https://docs.usequotable.com/workspace/plans-and-limits.md#brand-plans) vary · **In the app:** Sidebar → Analytics → Prompts

A **prompt** is a question a buyer would type into ChatGPT, Google or another AI engine. Quotable asks every active prompt to every engine the brand tracks, every day. Your prompts decide what your metrics measure, so they are the most important part of your setup.

## What makes a good prompt

> [card] Sounds like a buyer
>
> "What's the best project management tool for a 20-person agency?" rather than "project management software agency".

> [card] Mostly unbranded
>
> Questions that do not name you show whether engines recommend you on their own. Branded prompts name you almost by definition.

> [card] Covers the journey
>
> Mix problem questions, "best" and comparison questions, alternatives, and questions about pricing or fit.

> [card] Specific enough to answer
>
> Add the constraint a real buyer has: team size, budget, industry, location, use case.

### Prompt types

The Prompts table labels each prompt on two axes, worked out from its text:

| Axis | Values | Rule |
| - | - | - |
| **Type** | Branded, Competitor, Organic | Branded if it contains your brand name; Competitor if it contains a tracked competitor's name; otherwise Organic |
| **Intent** | Commercial, Informational | Commercial if it uses buying language such as "best", "top", "tools", "software", "platforms", "recommend", "alternatives" or "vs"; otherwise Informational |

A set heavy in branded prompts makes every visibility number look better than it is. Keep most prompts organic, and use the **Unbranded prompts** filter on the Overview to read the honest number.

> [!TIP]
>
> Write each prompt in the language your buyers use in that prompt's location. Quotable asks the prompt exactly as written.

## Prompt limits

Prompts are a pool shared by every brand in the workspace. How many active prompts the pool holds depends on your plan. See [Plans and limits](https://docs.usequotable.com/workspace/plans-and-limits.md#brand-plans).

Agency plans count answers instead of prompts: a prompt holds one slot for each AI engine its client tracks. See [Agency plans](https://docs.usequotable.com/agencies/overview.md).

* **Only active prompts count.** Pausing a prompt, or pausing its brand, frees its slot. Resuming one is refused if the pool has no room left for it.
* The Prompts page shows your usage, for example "32 of 300 prompts used · 10 on other brands".
* Prompt text must be 3 to 500 characters.
* A prompt with the same text in the same location as an existing one is skipped as a duplicate, not added twice.

When a batch would go over the pool, nothing in the batch is added, and Quotable names your plan, the size of its pool and how many prompts you already have.

## Add prompts

On the brand's **Prompts** page, choose **Add prompts**. The dialog has four tabs:

| Tab | What it does |
| - | - |
| **Add prompt** | Write or paste prompts, one per line |
| **Generate** | Quotable drafts prompts from **Your website**, **Keywords**, **A specific page** or **A description**. Pick an **Amount** (5, 10 or 25), a **Prompt type** or **Any type**, and optional **Instructions**. Each draft is labeled Commercial, Competitor, Branded or Informational, with its estimated monthly AI search volume when known. **Generate more** adds another set |
| **Fan-outs** | Searches the engines ran in the last 30 days while answering your prompts, which you do not track yet. Each shows how often it was seen. See [Query fan-outs](https://docs.usequotable.com/analyze/query-fan-outs.md) |
| **Bulk upload** | A CSV file with one prompt per row and an optional topic column, up to 1 MB and 1,000 rows. **Download an example** shows the format |

Choose a **Topic** and a **Location** (the default is the brand's location and language), select the prompts, and add them. In a bulk upload, a row's own topic wins over the one you pick.

You can also add a prompt from [Prompt Volumes](https://docs.usequotable.com/analyze/prompt-volumes.md) with **Track a question**.

> [!NOTE]
>
> Adding prompts queues a first run for them right away, on every engine the brand tracks. You see their answers without waiting for the next daily run. You need to confirm your email address before you can add prompts.

## Topics

Every prompt belongs to one **topic**, a short theme such as "Rank Tracking" or "Pricing". Topics group the Overview, Competitors and reports, and are a filter on both pages.

* Prompts from brand setup keep the topic they were generated under.
* When you add prompts, you can pick a topic or create a new one.
* Prompts added without a topic are classified automatically the next time the brand's Overview loads. A prompt that cannot be classified goes under **General**.
* Once a prompt has a topic, it is not reclassified.

## Pause, resume and delete

| Action | Where | Effect |
| - | - | - |
| **Pause tracking** | Prompt row menu, or select several and choose **Pause** | Stops new runs. History stays in every view. Still counts toward your pool |
| **Resume tracking** | Prompt row menu, or **Resume** in bulk | Runs again from the next daily run |
| **Delete** | Prompt row menu, or **Delete** in bulk | Deletes the prompt and its entire history. A single delete has no confirmation step |

Use the **Active** and **Inactive** filters to see each group.

> [!WARNING]
>
> Deleting a prompt removes its past answers from every chart, so past numbers change. Pause a prompt if you want to keep its history.

## Locations per prompt

Every prompt runs in the brand's default location unless you set another one in the **Location** column, or with **Set location** on a selection. Your plan caps how many locations one brand can span. See [Locations and languages](https://docs.usequotable.com/setup/markets-and-languages.md).

## Next steps

> [card] [Analyze prompts](https://docs.usequotable.com/analyze/prompts.md)
>
> Read answers, citations and fan-outs per prompt.

> [card] [Engines and schedule](https://docs.usequotable.com/setup/engines-and-schedule.md)
>
> When prompts run, and on which engines.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.