Add live chat to Mintlify. DeskCrew support widget
DeskCrew adds AI live chat and ticketing to a Mintlify docs site with one small .js file in your content directory. Mintlify runs it on every page.
One paste on Mintlify
One script tag. No build step, no package to maintain, nothing that can break on a platform update. The exact steps are below.
AI drafts, humans approve
The AI drafts replies grounded in the knowledge base you publish, and every draft waits in an approval queue until a human sends it.
Every conversation is a ticket
Widget chats, emails, and board posts land in one dashboard with full history; visitors who leave get their answer by email.
Free plan, no card
The free plan includes the chat widget, a public knowledge base, and ticketing. Start free and upgrade only when you outgrow it.
How to install DeskCrew on Mintlify
Mintlify has no scripts field in docs.json. Custom JS is a file: add a .js file (e.g. deskcrew.js) inside your docs content directory, and Mintlify includes it on every page.
In that file, inject the widget: const s = document.createElement("script"); s.src = "https://deskcrew.io/desk.js"; s.dataset.key = "pub_YOUR_KEY"; s.dataset.board = "your-board"; s.defer = true; document.head.appendChild(s);
Commit and deploy. The chat bubble appears across your docs; your real key and board slug are on the DeskCrew dashboard’s Install page.
<script src="https://deskcrew.io/desk.js" data-key="pub_YOUR_KEY" data-board="your-board" defer></script>
pub_YOUR_KEY and your-board are placeholders. Your real widget key and board slug are in your DeskCrew dashboard under Install (free signup, no card).
Note: Custom JS is a paid Mintlify feature. “Custom CSS and JS” ships on Mintlify’s Pro and Enterprise plans, not the free Starter tier. The snippet below is what the .js file injects.
DeskCrew vs the usual suspects
| DeskCrew | Tidio | Crisp | Zendesk | |
|---|---|---|---|---|
| Free tier | Yes. Free plan, no card | Yes (limited) | Yes (basic) | Free trial only |
| AI included | Yes. AI drafts on every plan, human-approved | Paid add-on | Higher plans | Paid add-on |
| Setup | About 2 minutes. One script tag or plugin | Minutes. Script tag | Minutes. Script tag | Longer. Full workspace setup |
| Price floor | $0 free plan · paid from $29/mo | Free plan; paid tiers above | Free plan; paid tiers above | Per-agent pricing, no free plan |
Competitor cells generalize their public pricing pages. Always check current plans.
DeskCrew has a free plan with no card. Chat widget, public knowledge base, and ticketing included. Every new workspace starts with full Team features free for 14 days, and paid plans start at $29/mo. Full details on the pricing page.
FAQ. add live chat to Mintlify
How do I add live chat to a Mintlify docs site?
Drop a .js file in your content directory that appends the DeskCrew script tag (src plus data-key and data-board) to the page. Mintlify includes every .js file in the content directory on every page of your site.
Is there a scripts field in docs.json?
No. Docs.json (the successor to mint.json) has integrations for specific analytics vendors, but arbitrary script tags aren’t a config field. Custom JavaScript files in your content directory are Mintlify’s supported mechanism.
Does custom JS work on Mintlify’s free plan?
No. Mintlify lists “Custom CSS and JS” under its Pro and Enterprise plans. The DeskCrew side is free; the Mintlify side needs a plan that includes custom scripts.
My docs migrated from mint.json to docs.json. Does that change the install?
No. The custom-JS mechanism is file-based, not config-based, so it works the same before and after the docs.json migration. Nothing in docs.json needs to change.
Will custom JS slow down my Mintlify docs?
No. Mintlify runs custom JS after the page becomes interactive, and the injected DeskCrew tag is deferred on top of that. The widget draws in its own Shadow DOM, so nothing touches your docs styling.
Where do chats from my docs go?
Every conversation becomes a ticket in your DeskCrew dashboard. The AI drafts a reply grounded in your knowledge base, a human approves it, and readers who already left get the answer by email.