# Integrations (/organize/settings-integrations)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1837 · updated: 2026-07-30 -->
Related: [Global settings](/organize/settings.md), [Appearance and branding](/organize/settings-appearance.md), [Site structure](/organize/settings-structure.md), [API settings](/organize/settings-api.md), [SEO and search](/organize/settings-seo.md), [docs.json schema reference](/organize/settings-reference.md)

Use the `integrations` field in `docs.json` to connect third-party analytics platforms, chat tools, and other services to your documentation site.

## Settings [#settings]

Configure all integrations as properties of the `integrations` object in your `docs.json` file:

```json title="docs.json"
"integrations": {
  "ga4": {
    "measurementId": "G-XXXXXXXXXX"
  }
}
```

### Analytics [#analytics]

<ResponseField name="integrations.adobe" type="object">
  Adobe Analytics integration.

  <Expandable title="integrations.adobe">
    <ResponseField name="launchUrl" type="string (uri)">
      Your Adobe Analytics launch URL.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.amplitude" type="object">
  Amplitude analytics integration.

  <Expandable title="integrations.amplitude">
    <ResponseField name="apiKey" type="string">
      Your Amplitude API key.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.clarity" type="object">
  Microsoft Clarity session recording and heatmap integration.

  <Expandable title="integrations.clarity">
    <ResponseField name="projectId" type="string">
      Your Microsoft Clarity project ID.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.fathom" type="object">
  Fathom analytics integration.

  <Expandable title="integrations.fathom">
    <ResponseField name="siteId" type="string">
      Your Fathom site ID.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.ga4" type="object">
  Google Analytics 4 integration.

  <Expandable title="integrations.ga4">
    <ResponseField name="measurementId" type="string matching ^G">
      Your Google Analytics 4 measurement ID. Must begin with `G`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.gtm" type="object">
  Google Tag Manager integration.

  <Expandable title="integrations.gtm">
    <ResponseField name="tagId" type="string matching ^G">
      Your Google Tag Manager container ID. Must begin with `G`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.heap" type="object">
  Heap analytics integration.

  <Expandable title="integrations.heap">
    <ResponseField name="appId" type="string">
      Your Heap app ID.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.hightouch" type="object">
  Hightouch data activation integration.

  <Expandable title="integrations.hightouch">
    <ResponseField name="writeKey" type="string">
      Your Hightouch write key.
    </ResponseField>

    <ResponseField name="apiHost" type="string">
      Your Hightouch API host.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.hotjar" type="object">
  Hotjar heatmap and session recording integration.

  <Expandable title="integrations.hotjar">
    <ResponseField name="hjid" type="string">
      Your Hotjar site ID.
    </ResponseField>

    <ResponseField name="hjsv" type="string">
      Your Hotjar script version.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.logrocket" type="object">
  LogRocket session replay integration.

  <Expandable title="integrations.logrocket">
    <ResponseField name="appId" type="string">
      Your LogRocket app ID.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.mixpanel" type="object">
  Mixpanel product analytics integration.

  <Expandable title="integrations.mixpanel">
    <ResponseField name="projectToken" type="string">
      Your Mixpanel project token.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.pirsch" type="object">
  Pirsch privacy-friendly analytics integration.

  <Expandable title="integrations.pirsch">
    <ResponseField name="id" type="string">
      Your Pirsch site ID.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.plausible" type="object">
  Plausible privacy-friendly analytics integration.

  <Expandable title="integrations.plausible">
    <ResponseField name="domain" type="string">
      Your Plausible domain.
    </ResponseField>

    <ResponseField name="server" type="string">
      Your Plausible server, if self-hosting.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.posthog" type="object">
  PostHog product analytics integration.

  <Expandable title="integrations.posthog">
    <ResponseField name="apiKey" type="string matching ^phc_">
      Your PostHog API key. Must begin with `phc_`.
    </ResponseField>

    <ResponseField name="apiHost" type="string (uri)">
      Your PostHog API host. Required if self-hosting PostHog.
    </ResponseField>

    <ResponseField name="sessionRecording" type="boolean">
      Whether to enable session recording. Defaults to `false`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.segment" type="object">
  Segment customer data platform integration.

  <Expandable title="integrations.segment">
    <ResponseField name="key" type="string">
      Your Segment write key.
    </ResponseField>
  </Expandable>
</ResponseField>

### Chat and support [#chat-and-support]

<ResponseField name="integrations.frontchat" type="object">
  Front chat widget integration.

  <Expandable title="integrations.frontchat">
    <ResponseField name="snippetId" type="string">
      Your Front chat snippet ID. Minimum length: 6.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.intercom" type="object">
  Intercom customer messaging integration.

  <Expandable title="integrations.intercom">
    <ResponseField name="appId" type="string">
      Your Intercom app ID. Minimum length: 6.
    </ResponseField>
  </Expandable>
</ResponseField>

### Data enrichment [#data-enrichment]

<ResponseField name="integrations.clearbit" type="object">
  Clearbit visitor data enrichment integration.

  <Expandable title="integrations.clearbit">
    <ResponseField name="publicApiKey" type="string">
      Your Clearbit public API key.
    </ResponseField>
  </Expandable>
</ResponseField>

### Platform settings [#platform-settings]

<ResponseField name="integrations.telemetry" type="object">
  Mintlify telemetry settings.

  <Expandable title="integrations.telemetry">
    <ResponseField name="enabled" type="boolean">
      Whether to enable Mintlify telemetry. When set to `false`, feedback features are also disabled and do not appear on your documentation pages.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="integrations.cookies" type="object">
  Cookie settings for your documentation site.

  <Expandable title="integrations.cookies">
    <ResponseField name="key" type="string">
      Cookie key name.
    </ResponseField>

    <ResponseField name="value" type="string">
      Cookie value.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example [#example]

```json title="docs.json"
"integrations": {
  "ga4": {
    "measurementId": "G-XXXXXXXXXX"
  },
  "posthog": {
    "apiKey": "phc_XXXXXXXXXX"
  },
  "intercom": {
    "appId": "abc12345"
  },
  "telemetry": {
    "enabled": true
  }
}
```