Enable analytics

Start tracking page views, search queries, and reader engagement in minutes.

Mintlify tracks a baseline set of metrics automatically — page views, search queries, feedback votes, and AI assistant conversations — all visible in the dashboard without any setup. To get deeper insights, connect a third-party analytics provider.

What Mintlify tracks natively

Once your site is deployed, the Analytics tab in your project dashboard shows:

• Page views — Total and unique visitors per page, filterable by date range.
• Popular pages — Your most-visited pages, ranked by view count.
• Search queries — What readers type into your search bar, including queries that returned no results.
• Feedback — Thumbs up/down votes and optional written feedback collected on each page.
• AI conversations — Questions asked to your site’s AI assistant and whether they were answered.

No configuration required for any of the above.

Add a third-party analytics provider

For cohort analysis, custom funnels, or data that lives alongside your product metrics, connect a provider in docs.json:

1. Get your tracking ID or API key

   Log in to your analytics provider (Google Analytics 4, PostHog, Segment, Mixpanel, Plausible, or others) and find your measurement ID or write key.

2. Add it to docs.json

   Add an integrations block to your docs.json:

   "integrations": {
     "posthog": {
       "apiKey": "phc_your_key_here"
     }
   }
   

   See Connect an analytics provider for the exact field names for each supported provider.

3. Deploy and verify

   Push the change to your repository. After the deployment completes, visit your docs site and confirm events are appearing in your analytics provider’s dashboard. Use browser dev tools to verify the tracking script loaded if you don’t see events right away.

Next steps

• See all supported analytics providers and their configuration options.
• Learn what the native analytics dashboard shows and how to use it.