Connect an analytics provider - Product Guide

Mintlify integrates with most major analytics platforms. Add your provider’s credentials to docs.json and Mintlify injects the tracking script on every page automatically.

Supported providers

Product analytics
Web analytics
Session recording

PostHog
Mixpanel
Amplitude
Heap
Segment (as a source for any downstream destination)

Configuration

All providers are configured inside the integrations object in docs.json. Each entry uses the provider’s name as the key:

"integrations": {
  "ga4": {
    "measurementId": "G-XXXXXXXXXX"
  },
  "posthog": {
    "apiKey": "phc_your_key_here"
  }
}

You can configure multiple providers simultaneously. Mintlify loads all of them on every page.

Provider-specific fields

Provider	Key in docs.json	Required field
Google Analytics 4	`ga4`	`measurementId`
Google Tag Manager	`gtm`	`tagId`
PostHog	`posthog`	`apiKey`
Mixpanel	`mixpanel`	`projectToken`
Plausible	`plausible`	`domain`
Fathom	`fathom`	`siteId`
Hotjar	`hotjar`	`hjid`, `hjsv`
Segment	`segment`	`writeKey`
Amplitude	`amplitude`	`apiKey`

What Mintlify sends to your provider

Mintlify fires these events to connected providers:

Page view — Triggered on every page load, with the current URL.
Search — Triggered when a reader uses the search bar, including the query string.
Feedback — Triggered when a reader clicks the thumbs up/down on a page.
API playground request — Triggered when a reader sends a request from an API playground page.

⌘I