> ## Documentation Index
> Fetch the complete documentation index at: https://product-guide-starter-replace-template-content.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Add an integration

> Connect a third-party service to your docs site by adding a few lines to docs.json.

Mintlify integrations are configured in `docs.json` — no separate dashboard or plugin installation required. This guide covers the general pattern. See the pages in this section for provider-specific details.

## Before you begin

* Your API key, tracking ID, or credentials from the service you want to connect
* Write access to your documentation repository

## Steps

<Steps>
  <Step title="Get your credentials">
    Log in to the service you're connecting and find your API key, measurement ID, or project token. The exact location varies by provider — check the provider's documentation under "API keys" or "Tracking."
  </Step>

  <Step title="Add the integration to docs.json">
    Open `docs.json` and add an `integrations` object if it doesn't exist yet. Add your provider and credentials:

    ```json theme={null}
    "integrations": {
      "posthog": {
        "apiKey": "phc_your_key_here"
      }
    }
    ```

    For providers that need multiple fields (like Hotjar), the schema shows all required keys. See [authentication](/integrations/authentication) for how Mintlify handles credentials.
  </Step>

  <Step title="Deploy">
    Commit and push your updated `docs.json`. Mintlify deploys automatically and injects the integration script on every page.
  </Step>

  <Step title="Verify">
    Visit your docs site and open your browser's network tab. Confirm the provider's script loaded and that events are appearing in the provider's dashboard. Most providers show a real-time event stream you can use for verification.
  </Step>
</Steps>

<Note>
  You can add multiple integrations simultaneously. Each one listed in `docs.json` is loaded on every page of your site.
</Note>

## Next steps

* See [supported analytics providers](/analytics/connect-data) for analytics and session recording tools.
* Add a [chat or support widget](/integrations/connectors/crm) to let readers get help without leaving your docs.
* Use [custom scripts](/integrations/webhooks/configure) for anything not covered by a built-in integration.