Stay on Docusaurus while someone on your team owns its build; move to a managed platform such as Docsbook when nobody does and the upkeep keeps arriving anyway.
Docusaurus is a free, MIT-licensed static-site generator built on React and maintained by Meta Open Source. It gives you MDX, versioning and translations, and leaves hosting, search and upgrades to you.
Facts below are from docusaurus.io as of September 2026, when the current version was 3.10.2.
What does running Docusaurus actually cost?#
The licence is free; the hours are not. Price these line items against your own team's time:
| Line item | What it takes |
|---|---|
| Hosting | A build on every push, and a host to deploy the output to |
| Search | Not built in: apply to Algolia DocSearch (free for developer docs that meet its checklist) or run a community plugin |
| Major upgrades | The v3 upgrade moved MDX from v1 to v3, which compiles Markdown more strictly, and raised the minimum Node.js and React to 18 |
| Custom theme | Swizzled components you keep in step with each release |
| AI answers for readers | A separate service, plus the work to connect it |
| Translations | Locale routing is built in; producing the translations is yours |
On Docsbook these lines are part of the platform: hosting, the build and search on every plan, and AI answers and translations on Pro, $20 a month per project with $20 of AI usage included.
When should you stay on Docusaurus?#
Stay when the ownership cost is already paid. Any one of these is enough:
- React inside your pages — live demos, playgrounds and custom plugins. Docsbook renders Markdown and does not run JSX.
- Versioned docs — Docusaurus keeps
versioned_docs/per release; Docsbook has no version switcher. - Someone owns the site — it is in their job, and upgrades get done.
- No vendor at all — you accept hosting and upgrades as your own work.
When should you move?#
Move when the site has no owner and the work keeps landing on engineers anyway:
- The build breaks when a dependency moves, and nobody's week has room for it.
- Readers ask questions — the Docsbook AI chat answers from your pages and cites them (Pro).
- You sell in several languages — translations into 15 languages, each page at its own URL (Pro).
- Nobody has time to improve the docs — the Docsbook agent reads failed searches, unanswered questions and AI answers, checks pages against 299 published rules and sends pull requests. See Find wins fast.
- You would rather ask than configure — tell the agent what you want from Claude Code or Cursor (Get discovered).
How do the Docusaurus alternatives compare?#
Three of the five host the site for you; VitePress and Starlight are generators you host yourself, like Docusaurus. Prices are as of September 2026.
| Alternative | What it is | AI answers for readers | Price |
|---|---|---|---|
| Docsbook | Managed: publishes the Markdown in your GitHub repository, no config file, no build | AI chat on Pro | 14-day trial; Pro $20 a month per project |
| Mintlify | Managed: MDX pages plus a docs.json config |
Assistant on Pro | Starter $0; Pro $450 a month billed annually |
| GitBook | Managed: block editor with two-way Git Sync | AI search on Premium, Assistant on Ultimate | Free $0 per site; Premium $65 per site a month billed annually |
| VitePress | Static-site generator built on Vite and Vue; you host it | Add your own | Free, MIT licence |
| Starlight | Astro's docs framework with search, i18n and SEO built in; you host it | Add your own | Free, MIT licence |
What changes if you move to Docsbook?#
Your Markdown moves as it is; the machinery around it does not. On a custom domain, docs/intro.md publishes at /docs/intro, the same path Docusaurus serves by default.
- Kept —
.mdand.mdxfiles, folders, frontmattertitleanddescription, relative links to.mdfiles. - Rewritten —
:::noteadmonitions become callouts,<Tabs>become tabs, and imported React components go. - Dropped —
sidebars.js,_category_.jsonandsidebar_position: the folders order the sidebar. - Redirected — pages whose URL came from a
slugor a number prefix such as01-intro.md.
Migrating from Docusaurus to Docsbook has the steps and the conversions.
FAQ#
Is Docusaurus still a good choice in 2026?
Yes, for a team that owns it. It is maintained by Meta Open Source, free under the MIT licence, and strong on MDX, versioning and localisation; the cost is the hosting, search and upgrade work that comes with it.
Is self-hosting Docusaurus cheaper than a paid platform?
The invoice is smaller and the hours are larger. Compare the engineering time in the table above with a subscription such as Docsbook Pro at $20 a month per project.
Can I try Docsbook without touching my Docusaurus deploy?
Yes. Connecting the repository publishes a second site on a docsbook.io address; your Docusaurus deploy keeps serving readers until you move the domain.
Which Docusaurus alternatives have AI answers built in?
The managed ones: Docsbook (AI chat on Pro), Mintlify (Assistant on Pro) and GitBook (AI search on Premium, Assistant on Ultimate). With VitePress or Starlight you add an AI service yourself.