# PostHog (/integrations/analytics/posthog)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 589 · updated: 2026-07-30 -->
Related: [Analytics integrations](/integrations/analytics/overview.md), [Adobe Analytics](/integrations/analytics/adobe.md), [Amplitude](/integrations/analytics/amplitude.md), [Clarity](/integrations/analytics/clarity.md), [Clearbit](/integrations/analytics/clearbit.md), [Fathom](/integrations/analytics/fathom.md)

Add the following to your `docs.json` file to send analytics to PostHog.

You only need to include `apiHost` if you are self-hosting PostHog. By default, Mintlify proxies events through `https://ph.mintlify.com` to your PostHog project.

<CodeGroup>
  <CodeBlockTabs defaultValue="Analytics options in docs.json" groupId="analytics-options-in-docs-json+example">
    <CodeBlockTabsList>
      <CodeBlockTabsTrigger value="Analytics options in docs.json">
        Analytics options in docs.json
      </CodeBlockTabsTrigger>

      <CodeBlockTabsTrigger value="Example">
        Example
      </CodeBlockTabsTrigger>
    </CodeBlockTabsList>

    <CodeBlockTab value="Analytics options in docs.json">
      ```json  
      "integrations": {
          "posthog": {
              "apiKey": "YOUR_POSTHOG_PROJECT_API_KEY",
              "apiHost": "optional",
              "sessionRecording": true
          }
      }
      ```
    </CodeBlockTab>

    <CodeBlockTab value="Example">
      ```json  
      "integrations": {
          "posthog": {
              "apiKey": "phc_TXdpocbYTeZVm5VJmMzHTMrCofBQu3e0kN7HGMNGTVW"
          }
      }
      ```
    </CodeBlockTab>
  </CodeBlockTabs>
</CodeGroup>

### Configuration options [#configuration-options]

<ParamField path="apiKey" type="string">
  Your PostHog project API key. Must start with `phc_`.
</ParamField>

<ParamField path="apiHost" type="string">
  The URL of your PostHog instance. Only required if you are self-hosting PostHog. Defaults to `https://ph.mintlify.com` (Mintlify's PostHog proxy).
</ParamField>

<ParamField path="sessionRecording" type="boolean" default="true">
  Enable or disable session recording. Set to `false` to disable session recordings while keeping analytics enabled.
</ParamField>

## Session recordings [#session-recordings]

Configuring PostHog enables session recordings by default. To disable session recordings while keeping analytics enabled, set `sessionRecording` to `false` in your configuration.

```json title="Disable session recordings"
"integrations": {
    "posthog": {
        "apiKey": "phc_your-key",
        "sessionRecording": false
    }
}
```

You need to add the URL for your docs website to PostHog's "Authorized domains for recordings" before you can receive session recordings. The option to add your URL is in PostHog's project settings.