Documentation Platforms

Mintlify AI Integration

Add AI chat to your Mintlify docs in minutes

What is it?

About Mintlify

Mintlify is a modern documentation platform used by thousands of product and support teams to publish beautiful, searchable knowledge bases. It generates a public website from MDX files in your repository.

Integration capabilities

How BeforeQuery works with Mintlify

Everything you can do once the Mintlify integration is connected.

Automatic sitemap-aware crawl

BeforeQuery reads your Mintlify sitemap.xml, crawls every page, and normalizes content to clean markdown — stripping navigation, headers, and footers so only doc content is indexed.

Webhook-triggered re-indexing

Connect your Mintlify project's deploy webhook. Every time a new version of your docs goes live, BeforeQuery triggers an incremental sync so answers stay current without manual intervention.

Drop-in AI widget

Add the BeforeQuery widget to your Mintlify layout with one script tag. The widget respects your Mintlify theme colors and typography automatically.

Cited answers from your own content

Every answer includes links back to the exact Mintlify page and section — users click through to the source, not a generic AI summary.

Setup

How to connect Mintlify

Step 01
In the BeforeQuery dashboard, create a knowledge base and add your Mintlify docs URL as a source. BeforeQuery discovers all pages via the sitemap.
Step 02
Embed the widget script tag in your Mintlify custom layout, or use @beforequery/react if your docs site has a React wrapper.
Step 03
Optionally register a deploy webhook in Mintlify pointing to your BeforeQuery knowledge base sync endpoint so the index stays up to date on every deploy.

Explore

Related integrations

Docusaurus

Crawl, sync, and embed AI chat on any Docusaurus v2 or v3 documentation site.

GitBook

Index your GitBook spaces and let users ask questions with full links back to source pages.

ReadMe

Crawl your ReadMe docs hub and let users ask questions with grounded answers from your reference material.

Mintlify — Frequently Asked Questions

Common questions about connecting BeforeQuery to Mintlify.

No changes to your Mintlify project are required. BeforeQuery crawls your published Mintlify site directly using the public sitemap. You only need to add the widget script tag (or React component) to your layout and optionally register a deploy webhook so the index updates automatically on every publish.

Register your BeforeQuery knowledge base sync URL as a deploy webhook in the Mintlify dashboard. Every time Mintlify publishes a new version of your docs, the webhook triggers an incremental re-index so answers reflect the latest content within minutes.

Yes. You can configure URL exclusion patterns in your BeforeQuery source settings to skip pages you do not want indexed — for example, private beta or internal pages. The crawler also respects your robots.txt directives.

The widget inherits your page's font automatically and supports full CSS override via data attributes or a CSS override block. You can match colors, position, and launcher icon to your Mintlify theme without writing custom JavaScript.

BeforeQuery works with any Mintlify site via the standard script tag embed — no Mintlify-specific plugin is needed. If your Mintlify setup uses a custom React layout, you can use the @beforequery/react package for a more integrated experience.

Ready to connect Mintlify?

Start free. No credit card required. Connect your first integration in under 5 minutes.

Get started free