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

# Reports

> Build shareable reports from live visibility, competitor, citation and AI traffic blocks, then share them by link, PDF or scheduled email.

> [!NOTE]
>
> **Plans:** All plans · **In the app:** Sidebar → Analytics → Reports

A report is a document of live data blocks (visibility, competitors, citations, AI traffic) with your own words around them. Pick a date range once and every block follows it. Share the result as a link, download it as a PDF, or email it every week or month. Switch the sidebar to **Analytics** and open **Reports**.

## Create a report

From the reports list, click **Start from template** or **Blank report**.

| Template | Covers | Blocks |
| - | - | - |
| **Executive AI Visibility** | Visibility, competitors, gaps, next actions | Executive summary, Key takeaway, Visibility KPIs, Visibility Score and Share of Voice, Visibility Trend, Competitive summary, Competitor Ranking, Visibility by Platform, Query Coverage Gaps, Recommendations |
| **Competitive Landscape** | Share of voice, rankings, perception, citations | Competitive summary, Share of Voice and Sentiment Overview, Share of Voice Trend, Competitor Ranking, Platform Matrix, Brand Perception Ranking, Competitor Citations, Top Cited Domains |
| **AI Traffic & Referrals** | AI referrals, platforms, crawled pages | AI Referral KPIs, AI Referral Trend, AI Platform Mix, AI Crawler KPIs, Top AI Landing Pages, Crawl Activity Timeline, Crawlers by Platform, Most Crawled Pages |
| **Citations & Sources** | Cited domains, URLs, content types, fan-out | Citation KPIs, Source Content Types, Position Distribution, Top Cited Domains, Top Cited URLs, Your Cited Pages, Top Generated Queries, Fan-out by Topic |

To reuse your own layout, choose **Save as template…** from a report's menu. Saved templates are shared across the workspace and appear under **Saved templates** in the gallery.

## Blocks

Add blocks from the **Block library** on the left (click, drag, or drop beside another block to pair them), or type `/` on the page. Every block reads the report's date range and filters.

> [accordion] Summary (written from the data)
>
> | Block | Shows |
> | - | - |
> | Executive summary | Where visibility and share of voice closed, and how they moved |
> | Key takeaway | The one thing to act on next |
> | Competitive summary | Who leads, where you rank, and who moved most |
>
> Summaries are computed from the data and rewrite themselves when you change the range.

> [accordion] Visibility
>
> Visibility KPIs (score, mention rate, citation rate, average position, share of voice, each with its change), Visibility Score, Visibility Trend, Share of Voice, Share of Voice Trend, Average Position, Competitor Ranking (by visibility, share of voice, or both), Visibility by Platform, Platform Matrix (every brand by engine), Query Coverage Gaps (prompts where competitors are named and you are not), Position Distribution.

> [accordion] Topics and locations
>
> Topic Rankings, Topic × Platform Heatmap, Visibility by Location.

> [accordion] Sentiment
>
> Sentiment Overview (positive, neutral, negative) and Brand Perception Ranking.

> [accordion] Sources and citations
>
> Citation KPIs, Top Cited Domains, Top Cited URLs, Source Content Types, Your Cited Pages, Competitor Citations.

> [accordion] Query fan-out
>
> Top Generated Queries and Fan-out by Topic: the searches AI engines run behind your prompts.

> [accordion] Shopping
>
> Shopping KPIs, Shopping Visibility Trend, Top Products Mentioned, Merchant Share, Missing Shopping Prompts. Needs ChatGPT among your tracked engines.

> [accordion] Ads
>
> Ads KPIs and Top Advertisers seen beside AI answers.

> [accordion] AI traffic
>
> AI Referral KPIs (sessions, engagement, conversions), AI Referral Trend, AI Platform Mix, Top AI Landing Pages. Needs [Google Analytics 4](https://docs.usequotable.com/integrations/analytics.md#google-analytics-4) connected.

> [accordion] AI crawlers
>
> AI Crawler KPIs, Crawl Activity Timeline, Crawlers by Platform, Most Crawled Pages. Needs an Agent Analytics log source connected.

### Block settings

Open a block's **⋯** menu to:

* Rename its title.
* Change the chart type: Line, Area or Smooth line for trends; Donut, Bars or Horizontal bars for shares.
* Toggle **Show score**, **Competitors** and **Colorize**.
* Set visible table rows, from 3 to 50.
* **Put side by side** or **Full width**, **Duplicate**, **Open page** (jump to the matching page in the app), or **Delete**.

The footer of the menu says which filters the block follows, for example "Follows the date range only."

A block with no data says why and how to fix it, for example **Add competitors** or **Connect Google Analytics**.

## Date range and filters

| Setting | Options |
| - | - |
| Range | Last 7 days, Last 30 days (default), Last 90 days, Last 365 days, or a custom range up to today |
| Interval | Auto, Daily, Weekly, Monthly. Auto is daily up to 45 days, weekly up to 200 days, monthly beyond |
| Comparison | Always the previous period of the same length |
| Filters | Engines, topic, locations, competitors, and prompt type (all, branded, unbranded) |

Not every block follows every filter. Source blocks follow the date range, engines, topic, locations and prompt type; AI traffic and crawler blocks follow the date range only. Competitor selection applies to comparison blocks, keeps your brand included, and leaves the underlying answer totals unchanged. Locations and competitor selections are saved with the report. Each block's menu lists the filters it supports.

## Write and format

The formatting bar has undo and redo, text styles (Text, Heading 1–3, Callout), bold, italic, strikethrough, underline, link, highlight, lists, quote, callout and divider. The report saves automatically less than a second after each change; press `⌘S` to save at once. One undo history covers text, blocks, range, filters, options and agent edits.

**Document options (⋯)** controls the report header (logo and date range on every page), **Colorize charts**, **Page breaks** (each H2 starts a new PDF page), **Save as template…** and **Download PDF**.

Switch to **Preview** to see the report as readers will, as a web page or as A4 PDF pages.

## Report agent

Click **Agent** (`⌘J`) to open the report agent beside the page. It reads your data and edits the report directly:

* Insert, replace, move or remove blocks and text, or whole sections.
* Change a block's settings, title, the timeframe and filters.
* Build a whole report from one sentence.

Each edit is applied as one undoable change and marked **Applied**, **Undone** or **Could not apply**. The agent never states a figure it has not read. Starter prompts include "Review this report", "Find the strongest insight", "Tighten the structure and flow", "Prune weak or repetitive sections" and "Build a report about…".

Chats with the report agent are stored in your browser, per report.

## Share

Open **Share** and click **Publish** to create a link at `https://app.usequotable.com/r/<token>`.

| Mode | What viewers see |
| - | - |
| **Live data** | Today's numbers, every time they open it |
| **Snapshot** | The numbers and text frozen when you published, with a "Data as of" date. Click **Refresh** to update the snapshot |

* **Access**: anyone with the link can view it. It is not indexed by search engines. Add an optional password (8–128 characters) to require it too; a browser stays unlocked for 12 hours, and changing the password ends those sessions.
* **Revoke**: **Unpublish** makes the link return "not found". Publishing again brings back the same link. Deleting the report removes its link.
* **Expiry**: links do not expire.
* **Branding**: hide "Made with Quotable" per report, or set your name, logo, icon and colors for every report in **Settings → Reports**.

The menu shows how many times the link was viewed and when it was published.

## PDF

**Download PDF** opens A4 pages and your browser's print dialog; choose **Save as PDF**. It is available from the Share menu, Document options, each report's menu in the list, and the public link.

## Email

Both options need the report to be published: the email carries the link, not a PDF.

| Option | Details |
| - | - |
| **Share via email** | Send now to up to 20 recipients, with an optional message up to 1,000 characters |
| **Scheduled delivery** | **Weekly** (every Monday, 08:00 UTC) or **Monthly** (first of every month, 08:00 UTC), up to 20 recipients. Toggle **Active** or **Remove schedule** |

Recipients of a live link see the latest numbers. If you unpublish the report, the schedule pauses and sends resume once it is published again. If the link has a password, send it to recipients separately.

## Organize reports

The list has grid and list views, folders, sort (last updated, last viewed, created, name), filters (created by, published or not) and search. Each report's menu has **Open**, **Rename**, **Duplicate**, **Download PDF**, **Save as template**, **Move to folder** and **Delete**.

## Roles

Editors create, edit, share and schedule reports. Viewers can open reports, change the range and filters for themselves without saving, and download PDFs. See [Team and roles](https://docs.usequotable.com/workspace/team-and-roles.md).

## Next steps

> [card] [Visibility metrics](https://docs.usequotable.com/metrics/overview.md)
>
> What each number in a block means.

> [card] [Citations](https://docs.usequotable.com/analyze/citations.md)
>
> The data behind the source blocks.

> [card] [Connect GA4](https://docs.usequotable.com/integrations/analytics.md)
>
> Unlock the AI traffic blocks.


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