Does Intercom integrate with Docusaurus—or allow embedding content outside of the Help Center? | Community
Skip to main content


We use Docusaurus for all our documentation and would like to centralize onboarding by embedding Intercom checklists and product tours directly into our docs.

Our engineering team also built a custom search bot that scans our Docusaurus portal, but its button overlaps with the Intercom Messenger since both use similar placement and styling. To resolve this, we’re exploring two options:

  1. Embed Intercom content (like checklists and product tours) directly in Docusaurus pages, without relying on the Messenger or Help Center.

  2. Integrate our custom search bot into the Intercom Messenger via API, so we can unify both experiences in a single UI element.

Are either of these approaches supported? Or is there another recommended way to host or display Intercom-created content outside of the default Help Center and Messenger?

Thanks!

Hey ​@Dani Jakobson 

At the moment, Intercom Product Tours can be triggered programmatically using Intercom('startTour', 'tour_id'), which works well for embedding onboarding steps into your Docusaurus pages via custom buttons or triggers.

However, Checklists require the Messenger to be active and can’t be embedded directly into external UIs. On the custom bot side, Intercom’s Messenger doesn’t support injecting third-party bots or UI directly into the Messenger window.

While you could build a custom Messenger App, it’s limited to specific surfaces like the home screen or conversation cards not for replacing search. The best workaround for now is to reposition the Messenger launcher using CSS to avoid UI overlap, and trigger Tours where needed using the API.

Let me know if you’d like help with any of these setup steps.

Terms & ConditionsAccessibility statement