> ## 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.

# Chat and support widgets

> Embed a live chat or help widget on your docs site so readers can get answers without leaving.

Adding a chat widget to your Mintlify docs lets readers ask questions, file support tickets, or talk to your team without leaving the page they're reading. Most chat platforms provide a JavaScript snippet — Mintlify makes it easy to inject this on every page.

## Supported platforms

Mintlify has built-in support for several chat and support tools:

* **Intercom** — Customer messaging platform with in-app chat, bots, and ticket creation.
* **Crisp** — Live chat and helpdesk with a generous free tier.
* **Front** — Team inbox with a chat widget for customer-facing support.
* **Custom** — Any widget that loads via a JavaScript snippet.

## Set up Intercom

<Steps>
  <Step title="Find your App ID">
    Log in to Intercom and go to **Settings → Installation → Web**. Copy the App ID shown in the code snippet (the value after `app_id:`).
  </Step>

  <Step title="Add it to docs.json">
    ```json theme={null}
    "integrations": {
      "intercom": "your_app_id_here"
    }
    ```
  </Step>

  <Step title="Deploy and verify">
    Push the change. After deployment, visit your docs site — the Intercom chat bubble should appear in the bottom-right corner.
  </Step>
</Steps>

## Set up a custom widget

For chat platforms not listed above, use a custom script to inject their snippet:

```json theme={null}
"integrations": {
  "gtm": {
    "tagId": "GTM-XXXXXXX"
  }
}
```

Use Google Tag Manager to load any third-party script, including chat widgets, without adding code directly to your repository. This approach also makes it easy to update or swap providers later.

## Positioning and styling

Most chat widgets render in the bottom-right corner by default. Check your provider's documentation for positioning options. You can also use custom CSS in your `style.css` file to adjust the widget's position relative to other page elements.

<Tip>
  If your docs have an API playground or code blocks in the right margin, test the widget placement carefully to avoid overlap on narrower viewports.
</Tip>