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

# Reports and sharing

> What each weekly and quarterly report holds, why it never changes, and who can receive it.

Every [weekly report](https://docs.heralded.ai/concepts/daily-updates-and-weekly-reports.md#weekly-report) issues one report for your brand. Once a calendar quarter ends, Heralded issues a quarterly report over that quarter's weekly reports. A report is kept as it was when it issued: later answers, edits and corrections never change it, and its PDF is the same file every time you download it. The live pages always show the latest data.

**One-time** opens your brand's latest full Snapshot and lists your workspace's one-time Snapshots and Audits across all sites under **Earlier Snapshots**. Before your first weekly report, it says **Your first Snapshot is on its way**. Below it, **Run on another domain or market** starts a fresh Snapshot. [Snapshot](https://docs.heralded.ai/concepts/snapshot.md) describes them.

The first report measured part by part carries the line "Understood is now measured part by part." in its page, PDF and weekly email. Earlier reports stay as issued. See [Understood](https://docs.heralded.ai/methodology/how-ai-describes-you.md#understood).

## Opening a report

**Reports** in the rail opens your brand's reports on three tabs: **Weekly**, **Quarterly** and **One-time**. The weekly and quarterly tabs show the newest report in a **Latest** card with **Open** and, if you can send reports, **Share**. Earlier reports follow by headline, with the period each covers and how many people it was sent to. **Older reports** pages back through earlier ones. A report issued for an earlier site names that site.

A report opens on its own page with **Share** and a **More actions** menu. **Download PDF** sits in that menu and is ready shortly after the report issues; until then it reads **Being prepared**. The tables name your delivered work and your competitors, and each opens its panel.

## What a report holds

* **The headline:** where your brand stood and what changed during the period. Home's line also names work that needs your decision.
* **Where you stand:** your Heralded Score, Mentioned and Recommended in AI answers, your place among your tracked competitors, and the score over the last eight weekly reports. Understood and Praised follow. Your Google search figures sit beside them.
* **Your products in AI shopping:** for an ecommerce brand, the [product-card figures](https://docs.heralded.ai/concepts/products.md#figures), product changes and any evidence that could not be read, as the report kept them. The page and PDF keep the report's original meaning: earlier reports count covered topics, while new reports count all answers with organic product cards.
* **What moved:** changes from the report's own week, including findings completed just after its answers. Held losses with the same engines and likely cause share one row naming how many questions they affect. Sources are named by site.
* **Your focus:** the topics, competitors and markets you starred on [Strategy](https://docs.heralded.ai/concepts/strategy.md), each with where you stood: your Heralded Score on a topic or market with its change, your place on a topic, and a competitor's score beside yours, each with its own change.
* **Work completed:** the work delivered during the period, each with its result when the report issued: **Delivered**, **Cited** or **Paying off**. [Results](https://docs.heralded.ai/concepts/actions.md#results) explains the labels.
* **Pages cited for the first time:** your pages that AI answers cited in this report and in no earlier one. The PDF names five and counts the rest.
* **Competitors:** your tracked competitors by Heralded Score, each with its change.
* **Next week:** the work that needed your decision when the weekly report issued, with suggested and ongoing customer work beneath. Heralded's own updates and reports do not count as work in progress or scheduled work here. The newest report also names the next weekly report date and offers **Open Work** when a decision is waiting. Older reports keep their counts and have no **Open Work** button. PDFs and shared views have no **Open Work** button. Quarterly reports call this section **Next**. A report makes no forecast.

Every change follows the same [change rules](https://docs.heralded.ai/methodology/change.md) as the rest of Heralded: a move is called only when the paired test says it is real.

A section that had no data when the report issued stays marked as missing in that report. Your first report has no earlier report to compare with, so **What moved** is missing and its figures read **First report**. A figure with no measured value shows no change. When your Google search figures arrive after the first report, the live pages show them, and the first report keeps saying they were not measured.

A report for a brand in a [managed account](https://docs.heralded.ai/concepts/workspaces-and-brands.md#managed-accounts) leaves out the **Made with Heralded** line.

## The weekly report

A weekly report covers the time since the previous weekly report. It issues once the report's answers are read, and the Herald's conversation posts **Your weekly report is ready** with its headline. Nothing else about the report is posted in the conversation.

Choose **Open full Snapshot** to open the answers and evidence from that report's own week. **Weekly report** takes you back to the report you opened it from. Opening it uses no Snapshot credit and starts no run. The weekly report holds the PDF; its full Snapshot has no separate PDF, share cards or **Run again** action. A quarterly report has no full Snapshot link. A report too old to open as a Snapshot has no link either.

## The quarterly report

A quarterly report covers a calendar quarter, in UTC, and issues a day after the quarter ends. It opens with your goal: the revision that was current when the report issued, with Recommended on its questions then, where it stood when the goal was set and your target. A goal changed since keeps its old revision in that report. It then holds the same sections as a weekly report. Its figures pool the weekly reports completed in the quarter, with their change against as many weekly reports before them. **What moved** and the pages cited for the first time gather those of the quarter's weekly reports, and **Work completed** the work delivered during the quarter. It lists the weekly reports it covers. A quarter in which your brand issued no weekly report has no quarterly report.

## Sharing a report

Everyone who can see your brand's data can open every report: members of your workspace whose role can see brand data, people with [access to your brand](https://docs.heralded.ai/concepts/workspaces-and-brands.md#brand-access), and the agency that [manages your account](https://docs.heralded.ai/concepts/workspaces-and-brands.md#managed-accounts).

Members who can start work can send a report to other members of your workspace whose role can see brand data. Choose **Share** on the report, tick the teammates and choose **Send**. One send reaches up to 50 people; send again for the rest. A teammate it was already sent to shows the day it last went to them. Each person you choose gets an email with a link to the report. Anyone else cannot be chosen, and the send is refused: a Billing member, someone outside the workspace, someone with access to this brand alone, or a person from the agency that manages your account. Someone who leaves the workspace before the email goes out does not receive it. Viewers can open reports but cannot send them.

To share a full Snapshot outside your workspace, open it and choose **Share**, then set **General access** to **Anyone with the link**. Weekly Snapshots start restricted to people who can read your brand's reports. Members who can start work can change their access. Choose the workspace option to restrict it again, or **Turn off link** to disable the shared address. You can also download the weekly report's PDF and send it yourself.

## When your brand changes

When you change your brand's site, the reports issued for the earlier site stay listed under your brand, each with the site it measured.

When you delete a brand, its reports and their PDFs are deleted with it, those of earlier sites included.

## Reports in the API

`GET /v1/brands/{brand_id}/reports` and MCP `get_reports` list your reports, newest first. Each weekly edition's `scan_id` opens its full Snapshot and is null when unavailable. Quarterly editions have no `scan_id`. `GET /v1/brands/{brand_id}/reports/{report_id}/recipients` lists who a report was sent to. [Figures in the API](https://docs.heralded.ai/figures.md#reports) describes their fields.


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