# Analytics

> See how many people read your docs, which pages they read most, and whether pages helped them. Available on Pro and Enterprise.

Analytics shows how much your docs get read: total page views and your most-viewed pages over the last 30 days, what readers searched for and couldn't find, and what they answered to "Was this page helpful?". It's on Pro and Enterprise, with nothing to install.

## Open it

Click **Analytics** in your project's sidebar. It appears when the project owner's plan includes analytics, and everyone on the project can see it. A number beside it counts the questions your docs couldn't answer.

## What you see

| Metric | What it shows |
|--------|---------------|
| **Total views** | Page views across your whole site in the last 30 days |
| **Top page** | Your most-viewed page and its view count |
| **Top pages** | Up to 50 pages ranked by views |

Until your site gets its first visit, the page shows "No views yet".

## Questions your docs couldn't answer

Analytics lists what readers searched for on your site and found nothing, and the questions they asked [Ask AI](https://docs.typemark.dev/ai/ai-search) that it couldn't answer from any page, over the last 30 days, most asked first. The same questions show under **Needs you** on the project overview and in the editor's assistant.

With [AI writing](https://docs.typemark.dev/editor/ai-writing), click **Draft an answer** beside a question. The editor opens with the assistant set to **All pages** and the question filled in. Nothing runs until you send it, and you review every change before it's saved.

Only the text of the search or question is kept, with how many times it was asked each day. No IP address or reader identity is stored, and questions are deleted after 90 days.

## What counts as a view

- A view is one load of a published page.
- Repeat visits by the same reader to the same page within 15 minutes count once.
- Markdown versions, `llms.txt`, and MCP requests from AI tools aren't counted.

## Privacy

Analytics doesn't add a tracking script to your site. Typemark counts views on the server. To use your own analytics tool as well, see [Custom code](https://docs.typemark.dev/configuration/custom-code). To tell repeat visits apart, it hashes the reader's IP address and browser and keeps that hash for 15 minutes. What's stored long-term is a daily view count per page.

<Callout type="info">
  Views are counted on every plan. If you upgrade to Pro or Enterprise, the last 30 days of views are there from the start.
</Callout>

## Reader feedback

Turn on the feedback widget to ask "Was this page helpful?" at the end of every page. Readers answer **Yes** or **No**, then can add a comment of up to 500 characters.

<Steps>
  <Step title="Turn it on">
    In **Settings** > **Reader features**, turn on **Feedback widget**. Or set `"feedback_widget": true` under `features` in [`typemark.json`](https://docs.typemark.dev/configuration/typemark-json#features).
  </Step>
  <Step title="Read the results">
    Open **Analytics**. Under **Reader feedback** you'll see:

    - the share of helpful answers across your site,
    - helpful and not helpful answers for each page, sorted by the most "not helpful" first (click a column to sort by it),
    - the 20 latest comments, each linking to its page.
  </Step>
</Steps>

Each reader counts once per page. A reader who changes their answer updates it, and a comment written for their old answer is dropped.

Feedback belongs to a page. Deleting a page deletes its feedback, and so does renaming it, since a new path is a new page. Turning the widget off hides it from readers and keeps the results.

The widget needs analytics on the project owner's plan. On Free the setting has no effect.

### Privacy

The widget sets no cookies and loads nothing from other sites. Typemark doesn't store readers' IP addresses: to count each reader once per page, it keeps a keyed hash of their IP address and browser for that page, which can't be turned back into an IP address or matched across pages. Comments are stored as readers write them.
