---
title: Analytics & Insights
description: "Traffic, search, AI, and content health analytics for your documentation."
---

# Analytics & Insights

Every deployed doc site tracks usage automatically — no snippet to install, no cookie banners needed (tracking is anonymous by default). Open your project in the [dashboard](https://syntext.dev) → **Analytics**.

## Traffic

- **Page views & unique visitors** over time
- **Top pages** — what people actually read
- **Navigation flow** — how visitors move between pages
- **Bounce rate, time on page, device/browser/geo breakdowns**
- **Referrers** — where readers come from

## Search Insights

- **Popular searches** — what visitors look for most
- **Zero-result queries** — searches that found *nothing*. This is your highest-signal backlog: people told you exactly what's missing.
- **Click-through** — which results get clicked per query

## AI Insights

The AI assistant is an always-on user interview:

- **Questions asked** and answer confidence over time
- **Thumbs up/down feedback** per answer, rolled up into a satisfaction rate
- **Confidence by topic** — which areas of your docs the AI answers well (and which it doesn't)
- **Unresolved intents** — questions the AI couldn't answer confidently, ranked by frequency. Each one is a page you should write.

### Always Up to Date

The assistant's knowledge index rebuilds automatically on every deploy — new and changed pages are re-chunked and re-embedded as part of the build pipeline, so answers always reflect your latest published content. No manual step required. (A [retrain endpoint](/api-reference/chat/retrain) exists to force a full rebuild if you ever need one.)

## Content Health

A 0–100 score per page and for the whole site, based on:

- **Freshness** — pages untouched for 90+ days are flagged stale
- **Feedback** — pages with negative "was this helpful?" ratios
- **Broken links**
- **Annotation coverage** — % of your public API symbols that are documented ([details](/api-reference/analytics/annotation-coverage))

Content owners are notified when their pages degrade — see [Collaboration](/platform/collaboration).

## DX Funnel

For API-first products, Syntext tracks the developer journey: docs visit → API playground usage → first successful API call, including **time-to-first-call** — the metric that predicts activation.

## Programmatic Access

Everything above is queryable via the [Analytics API](/api-reference/analytics/overview) for custom reports and BI exports.

<Note>
Tracking beacons return `202` and never block page rendering. Analytics collection respects the visitor's Do Not Track setting.
</Note>
