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

1. 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:).

2. Add it to docs.json

   "integrations": {
     "intercom": "your_app_id_here"
   }
   
3. Deploy and verify

   Push the change. After deployment, visit your docs site — the Intercom chat bubble should appear in the bottom-right corner.

Set up a custom widget

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

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

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.