Automatically send data about your documentation engagement to your third party analytics provider.

​
All integrations

Amplitude

Mixpanel

PostHog

Google Analytics 4

Google Tag Manager

Hightouch

HotJar

Koala

LogRocket

Pirsch

Plausible

Fathom

Clearbit

Heap

Segment

​
Enabling analytics

Set your analytics keys in docs.json. You can add an unlimited number of analytics integrations for free. The syntax for docs.json is below. You only need to include entries for the platforms you want to connect.
Analytics options in docs.json
"integrations": {
    "amplitude": {
        "apiKey": "required"
    },
    "clearbit": {
        "publicApiKey": "required"
    },
    "cookies": {
      "key": "required",
      "value": "required"
    },
    "fathom": {
        "siteId": "required"
    },
    "ga4": {
        "measurementId": "required"
    },
    "gtm": {
        "tagId": "required"
    },
    "hightouch": {
        "apiKey": "required",
        "apiHost": "optional"
    },
    "hotjar": {
        "hjid": "required",
        "hjsv": "required"
    },
    "koala": {
        "publicApiKey": "required"
    },
    "logrocket": {
        "appId": "required"
    },
    "mixpanel": {
        "projectToken": "required"
    },
    "pirsch": {
        "id": "required"
    },
    "plausible": {
        "domain": "required"
    },
    "posthog": {
        "apiKey": "required",
        "apiHost": "optional"
    },
    "segment": {
      "key": "required"
    },
    "telemetry": {
      "enabled": "boolean"
    }
}

​
Analytics events

We send the following events to your analytics provider. All events use the docs. prefix.
Event nameDescription
docs.accordion.closeWhen a user closes an accordion.
docs.accordion.openWhen a user opens an accordion.
docs.api_playground.requestWhen a user calls an API in the API playground.
docs.code_block.copyWhen a user copies code from a code block.
docs.code_block.ask_aiWhen a user asks the assistant to explain a code block.
docs.content.viewWhen a user views a page. Only available for analytics providers that do not track page views by default.
docs.feedback.thumbs_upWhen a user clicks the positive feedback button.
docs.feedback.thumbs_downWhen a user clicks the negative feedback button.
docs.navitem.cta_clickWhen a user clicks a call to action.
docs.expandable.closeWhen a user closes an expandable.
docs.expandable.openWhen a user opens an expandable.
docs.navitem.clickWhen a user clicks a header navigation item.
docs.footer.powered_by_mintlify_clickWhen a user clicks the “Powered by Mintlify” link.
docs.assistant.source_clickWhen a user clicks a citation in a chat.
docs.assistant.suggestion_clickWhen a user clicks a suggestion in a chat.
docs.assistant.thumbs_upWhen a user clicks the positive feedback button in a chat.
docs.assistant.thumbs_downWhen a user clicks the negative feedback button in a chat.
docs.assistant.completedWhen a chat session is completed.
docs.assistant.enterWhen a user initiates a chat.
docs.assistant.sharedWhen a user shares a chat conversation.
docs.search.closeWhen a user closes the search bar.
docs.search.result_clickWhen a user clicks a search result.
docs.context_menu.copy_pageWhen a user copies the current page as markdown.
docs.context_menu.copy_mcp_linkWhen a user copies the hosted MCP server link.
docs.context_menu.ai_provider_clickWhen a user clicks an AI provider and create a conversation with current page as context.
docs.context_menu.install_mcp_serverWhen a user installs the hosted MCP server on code editors.