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

# Analytics Annotations

> Add dated notes to site or organization charts so deployments, campaigns, and incidents explain the traffic spikes and dips beside them.

Annotations are **dated notes drawn on your time-series chart** — "Deployed v2", "Launched campaign", "Press mention" — so when traffic spikes or dips, the reason sits right next to it. Instead of trying to remember what happened on a given day, you mark it once and everyone reading the chart sees the context.

## How do I add an annotation?

You place an annotation directly on the chart:

<Steps>
  <Step title="Arm the Annotate tool">
    Click **Annotate** above the time-series chart. This arms placement without disturbing the chart's normal zoom and hover.
  </Step>

  <Step title="Click the date">
    Click the point on the chart where you want the note. A dialog opens for that date.
  </Step>

  <Step title="Write and save">
    Enter the note and choose its scope (this site, or your whole organization), then save. A vertical marker appears at that date.
  </Step>
</Steps>

## Verify

<Check>
  Your annotation is saved when the chart shows a vertical marker on the date you selected. Hover the marker to read its note or open the popover to **edit** or **delete** it.
</Check>

## Should an annotation be site or global?

Each annotation has one of two scopes:

| Scope      | Shows on                                 |
| ---------- | ---------------------------------------- |
| **Site**   | Only this site's chart.                  |
| **Global** | Every site's chart in your organization. |

Use **global** for things that affect all your sites at once — a company-wide launch, an infrastructure change — and **site** for anything specific to one property. A global annotation created on another site shows on your chart as read-only; you edit it from the site it belongs to.

## Who can add annotations?

Adding, editing, and deleting annotations requires an **owner or admin** role on the site. Every signed-in member can *see* annotations on the chart.

<Info>
  Annotations are an authenticated-viewer feature: they never appear on public or embedded dashboards, so a shared or embedded chart stays clean.
</Info>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Do annotations show on public or embedded dashboards?">
    No. Annotations are an authenticated-viewer feature in tinyanalytics, so they never appear on a public or embedded dashboard. Every signed-in member of your site can see them on the time-series chart.
  </Accordion>

  <Accordion title="Can I edit or delete an annotation after saving it?">
    Yes, if you have an owner or admin role on the site. Hover the annotation's vertical marker on the chart and use the popover to edit or delete it. A global annotation created on another site is read-only here — edit it from the site it belongs to.
  </Accordion>
</AccordionGroup>

## Related

<Columns cols={2}>
  <Card title="Compare periods" icon="arrow-right-arrow-left" href="/docs/analytics-period-comparison">
    Pair a note with a baseline to explain a change.
  </Card>

  <Card title="Dashboard overview" icon="gauge" href="/docs/web-analytics-dashboard">
    The time-series chart annotations sit on.
  </Card>

  <Card title="Export" icon="file-arrow-down" href="/docs/export-analytics-data">
    Download the data behind an annotated chart.
  </Card>

  <Card title="Filter your data" icon="filter" href="/docs/analytics-filters">
    Narrow the chart before reading its annotations.
  </Card>
</Columns>


## Related topics

- [Analytics Period Comparison](/docs/analytics-period-comparison.md)
- [Analytics Roles and Permissions](/docs/analytics-roles-permissions.md)
- [Analytics Read API](/docs/api-reference/analytics-read-api.md)