> ## 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.

# Pitches

> Track a prospect's AI visibility for 7 days before they sign: start a pitch, refresh it by hand, send a report in the prospect's own colours, and convert it into a client.

> [!NOTE]
>
> **Plans:** Freelancer, Agency and Growth, [limits](https://docs.usequotable.com/workspace/plans-and-limits.md#agency-plans) vary · **In the app:** Brand switcher → Pitches

A **pitch** tracks a prospect's brand for **7 days** so you can show them how AI engines describe them before they become a client. It works like a brand, with prompts, competitors, dashboards and reports. It draws on its own prompt pool, so it never takes answers or client slots from the clients you already have. When the window ends the pitch becomes read-only. If you win the account, convert it into a client and keep its history.

Pitches are part of the [agency plans](https://docs.usequotable.com/agencies/overview.md).

## The pitch pool

Active pitches share one pool of prompts. Its size depends on your plan. See [Plans and limits](https://docs.usequotable.com/workspace/plans-and-limits.md#agency-plans).

* **A pitch prompt counts once**, whatever the number of engines the pitch tracks.
* **The pool is concurrent, not monthly.** Pausing, ending or converting a pitch gives its prompts back at once, so the pool can serve a new prospect the same day.
* **Pitches never count against your answers or your client limit.**

When the pool is full, a new pitch or extra prompts are refused with a message that gives the pool's size and how much of it is in use, and asks you to pause or convert a pitch to free some.

## Start a pitch

Open the brand switcher at the top of the sidebar, switch to the **Pitches** tab and click **New pitch**. You can also click **All brands**, open the **Pitches** tab and click **New pitch**.

**1. Details**

Enter the prospect's **Website**, then choose the **Location**, **Language** and up to four **AI models**. Click **Continue**.

**2. Research**

Quotable reads the site, finds competitors, chooses topics and writes prompts, as it does for a client.

**3. Review**

Trim the competitors and prompts, then click **Start pitch**. The first run starts at once, and the 7 days start counting from creation.

Each prospect domain can have one pitch per workspace. A second one is refused with "This domain already has a pitch in this workspace." Keep prompts focused: every prompt holds a slot in the pitch pool while the pitch is active.

## What a pitch includes

A pitch covers AI visibility, the evidence you take to a prospect:

* **Overview**, **Prompts**, **Citations**, **Sentiment**, **Query fan-outs**, **Page Tracker**, **Source Gaps** and **Social**
* **Views** and **Reports**
* The brand's settings, including its competitors

Everything else opens after you convert, including Quotable Agent, routines, Tables, Opportunities, Agent Analytics, Shopping, connectors and the FactCheck tab of Sentiment. Those entries show a lock in the sidebar with the label **Needs a client project**. Opening one shows **Not part of a pitch**, with **Convert to client** beside it. Anything that would use credits on a pitch is refused, wherever it starts: "This isn't part of a pitch. Convert the pitch to a client to use it." A pitch never uses your credits.

## Inside a pitch

The top bar shows **Pitch** next to the brand name, with its state:

| Pill | Meaning |
| - | - |
| **5d left** | Active. Tracked daily. |
| **Paused · 5d left** | Not tracked. Its prompts are back in the pool. |
| **Ended · read-only** | The 7 days are over. |

Next to it are the pitch's controls:

| Control | What it does |
| - | - |
| **Refresh** | Runs the prompts now. See [Manual runs](#manual-runs). |
| **Pause** / **Resume** | Stops or restarts tracking |
| **Usage** | Prompts in this pitch, prompts held by all active pitches, what is free in the pool, refreshes left and the end date |
| **Report** | Opens the pitch's reports |
| **Convert to client** | Turns the pitch into a client. See [Convert a pitch](#convert-a-pitch-into-a-client). |

### Manual runs

A pitch runs on the daily schedule. On top of that, each pitch has **5 manual runs** for its whole window. **Refresh** shows how many are left.

* You can refresh at most once a day, and only while the pitch is active.
* If today's answers are already in, Quotable says "Today's answers are already in. Nothing new to run." No refresh is spent.
* Once all five are used: "This pitch has used its 5 manual runs. It still runs on its daily schedule."

### Pause and resume

**Pause** stops tracking and returns the pitch's prompts to the pool. **The days keep counting** while it is paused. You cannot add prompts to a paused pitch. **Resume** tracks it again until its end date, if the pool has room for its prompts.

## When the 7 days end

At the end of its window a pitch stops tracking and becomes **read-only**, with no action needed from you. It holds nothing in the pitch pool. Its dashboards and reports stay readable, but prompts, competitors, settings and runs cannot change: "This pitch has ended and is read-only. Convert it to a client to keep working on it."

An ended pitch can still be converted, or deleted by an owner.

## Reports in the prospect's colours

When you start a pitch, Quotable reads the prospect's site for its icon and brand colours. A pitch's reports can use that look instead of your workspace branding, in the editor, the PDF and the shared link.

In a report, open **Document options (⋯)** and choose **Prospect branding…**:

* Turn on **Use \[prospect]'s look**. Off keeps your workspace branding.
* Pick one of the colours found on the site, or enter your own as `#rrggbb`.
* **Read the site** or **Read again** fetches the icon and colours again.

A pitch keeps this look after you convert it. Share the report by link or PDF as usual. See [Reports](https://docs.usequotable.com/actions/reports.md).

## Convert a pitch into a client

Click **Convert to client** in the top bar or at the foot of the sidebar, or **Convert** in the pitches list. Converting works while the pitch is active, paused or ended. **It cannot be undone.**

The pitch becomes a client with every feature unlocked. It keeps its prompts, competitors and results, and daily tracking continues. As a client it shares the answer pool with no reservation, and its prompts count once per engine. Conversion is refused when:

* Your plan has no free client slot. Free a slot or upgrade.
* Its prompts on its engines need more answers than are left: "As a client this pitch needs 60 answers a day and your plan has 40 answers a day left. Free answers in a client or upgrade to convert it."

After converting, manage it like any other client. See [Clients](https://docs.usequotable.com/agencies/clients.md).

## The pitches list

Click **All brands** and open the **Pitches** tab. The header shows how many pitches are active, the pitch prompts in use out of your pool, and the length of a pitch. Filter by **All**, **Active**, **Paused** or **Ended**. Active pitches come first, soonest to end on top.

| Column | What it shows |
| - | - |
| **Pitch** | Name and domain. Click to open it. |
| **Status** | Active with days left, paused, or ended |
| **Visibility** and **Share of voice** | Over the pitch so far, or "—" before its first answers |
| **Prompts** and **Models** | What it tracks |
| **Started** | When it was created |

Each row has **Convert** and a menu with **Reports**, **Pause** or **Resume**, and **Delete pitch**. Deleting removes the pitch's prompts, competitors and every answer collected, and cannot be undone.

Starting, refreshing, pausing and converting need edit access, and only owners can delete. Pitches follow [brand access](https://docs.usequotable.com/workspace/team-and-roles.md#brand-access) like any brand.

## Next steps

> [card] [Clients](https://docs.usequotable.com/agencies/clients.md)
>
> Where a converted pitch goes next.

> [card] [Reports](https://docs.usequotable.com/actions/reports.md)
>
> Build the report you send the prospect.

> [card] [Share of voice](https://docs.usequotable.com/metrics/share-of-voice.md)
>
> The number most prospects ask about first.


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