Docusaurus 3.7 | Docusaurus
Upgrading should be easy. Our release process respects Semantic Versioning. Minor versions do not include any breaking changes.
From now on, all newly initialized sites will run on React 19 by default, and React 19 will be the minimum required version Docusaurus v4.
However, React 18 remains supported, and existing Docusaurus sites can either choose to stay on React 18, or upgrade their dependencies to React 19:
React 19 is a bit heavier than React 18. Since we support both versions, we don't leverage yet the new features that are exclusive to React 19.
Here are good reasons to upgrade your site before Docusaurus v4: You have custom React code and want to ensure it is ready for React19 You plan to leverage the brand-new React 19 features in your own code You use custom or third-party plugins and want to ensure their compatibility You have a monorepo and want to align the React dependency to v19 for all packages
Along the way, we fixed all the remaining hydration errors reported by React 19, some of them produced by our aggressive HTML minifier settings.
