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

# Analytics

> Check traffic for your published site — pageviews, top breakdowns, and chart annotations.

Fimo records pageview aggregates for your **published** site (preview traffic isn't tracked) and exposes them through `fimo analytics`. Every org gets a free 7-day retention preview; longer ranges and retention are a paid feature.

## Commands

```bash theme={null}
fimo analytics pageviews [--preset <p>] [--days 7|30|90] [--from YYYY-MM-DD] [--to YYYY-MM-DD] [--group-by day|week|month]
fimo analytics top <dimension> [--limit N]
fimo analytics annotations list
fimo analytics annotations set <YYYY-MM-DD> "<content>"
fimo analytics annotations delete <YYYY-MM-DD>
```

`pageviews` returns everything in one payload — KPIs (visitors, pageviews, bounce rate, views/visit, average visit duration), the visitors time series, and five top breakdowns. `<dimension>` for `top` is one of `pages`, `browsers`, `devices`, `countries`, or `sources`.

```bash theme={null}
fimo analytics pageviews --days 7          # traffic since last week
fimo analytics top countries               # where visitors come from
```

## Date ranges

Presets include `today`, `yesterday`, `this_week`, `last_week`, and `last_7_days` (free for everyone), plus `last_30_days`, `last_90_days`, `this_month`, `last_month`, `last_quarter`, `last_year`, and `custom`.

<Note>
  The free tier is a 7-day retention window, so short ranges work for everyone. Extended date ranges and longer retention are **paid** — asking for one as a free user returns an upgrade hint. See [fimo.ai/pricing](https://fimo.ai/pricing).
</Note>

## Chart annotations

Annotations are short per-day notes that appear on the dashboard chart — useful for marking deploys, launches, or anything that explains a traffic delta:

```bash theme={null}
fimo analytics annotations set 2026-05-20 "Launched homepage redesign"
fimo analytics annotations delete 2026-05-20
```

The date must be on or after the project's creation date and not in the future. A natural pattern: after `fimo deploy --publish` for a notable change, set an annotation with the commit message so the chart shows what changed when.

## What's next

<Columns cols={3}>
  <Card title="Deploy & publish" icon="cloud-arrow-up" href="/docs/deploy/overview">
    Publish so analytics start recording.
  </Card>

  <Card title="Custom domains" icon="globe" href="/docs/deploy/custom-domains">
    Put your site on your own URL.
  </Card>

  <Card title="Billing & credits" icon="credit-card" href="/docs/collaboration/billing-and-credits">
    What extended ranges require.
  </Card>
</Columns>