# Docusaurus v3.10.0 — 3.10.0 - Product: Docusaurus (https://whatsnew.fyi/product/docusaurus) - Vendor: Meta - Date: 2026-04-07 - Version: v3.10.0 - Original notes: https://github.com/facebook/docusaurus/releases/tag/v3.10.0 - Permalink: https://whatsnew.fyi/product/docusaurus/releases/v3.10.0 What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog. Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'. --- - **added** — Add `future.v4.mdx1CompatDisabledByDefault` flag - **added** — Promote `siteConfig.storage` to stable and add `future.v4.siteStorageNamespacing` flag - **added** — Support custom html elements in head tags - **changed** — Update init template to `.mdx` extension and strict MDX syntax - **changed** — Newly initialized TypeScript sites now use strict: true - **added** — Enable creation of Docusaurus sites in current directory - **added** — Improve npm supply chain security with improved Dependabot config - **added** — Use trusted publishing (OIDC) for canary releases - **changed** — Docusaurus Faster is stable and v4 future flag turns it on by default - **added** — The `write-heading-ids` CLI now supports the `--syntax` and `--migrate` options - **added** — Add support for explicit `headingId` based on MD/MDX comments - **added** — Add reset button to theme-live-codeblock and wire `position` prop - **changed** — Split ``, improve extensibility, better handling of emoji icons, and stabilize classNames - **changed** — Use React context for `` and allow custom `` components - **changed** — Upgrade to Rspack 1.7 and remove useless experimental feature flags - **added** — Add support for Markdown file path links in pages plugin - **added** — Add admonitions directive support for class/id shortcuts - **added** — Add MDXComponents/Li to swizzle config - **added** — Allow overriding transformSearchClient in theme-search-algolia - **added** — Add support for DocSearch v4.3.2 and new Suggested Questions - **added** — Add new siteConfig `future.experimental_vcs` API and `future.experimental_faster.gitEagerVcs` flag ##### 3.10.0 (2026-04-07) ###### :rocket: New Feature - `docusaurus-types`, `docusaurus` - [#11896](https://github.com/facebook/docusaurus/pull/11896) feat(core): add `future.v4.mdx1CompatDisabledByDefault` flag ([@slorber](https://github.com/slorber)) - [#11797](https://github.com/facebook/docusaurus/pull/11797) feat(core): promote `siteConfig.storage` to stable + add `future.v4.siteStorageNamespacing` flag [Claude] ([@slorber](https://github.com/slorber)) - [#11571](https://github.com/facebook/docusaurus/pull/11571) feat(core): support custom html elements in head tags ([@lebalz](https://github.com/lebalz)) - `create-docusaurus` - [#11897](https://github.com/facebook/docusaurus/pull/11897) feat(create-docusaurus): update init template to `.mdx` extension and strict MDX syntax ([@slorber](https://github.com/slorber)) - [#11696](https://github.com/facebook/docusaurus/pull/11696) feat(create-docusaurus): Newly initialized TS sites should use "strict: true" ([@slorber](https://github.com/slorber)) - [#11611](https://github.com/facebook/docusaurus/pull/11611) feat(create-docusaurus): enable creation in current directory ([@Mcheung7272](https://github.com/Mcheung7272)) - Other - [#11874](https://github.com/facebook/docusaurus/pull/11874) feat(ci): improve npm supply chain security - improve Dependabot config ([@slorber](https://github.com/slorber)) - [#11712](https://github.com/facebook/docusaurus/pull/11712) feat(publish): Use trusted publishing (OIDC) for canary releases ([@slorber](https://github.com/slorber)) - `create-docusaurus`, `docusaurus-bundler`, `docusaurus-plugin-content-blog`, `docusaurus-plugin-content-docs`, `docusaurus-plugin-content-pages`, `docusaurus-plugin-pwa`, `docusaurus-types`, `docusaurus` - [#11802](https://github.com/facebook/docusaurus/pull/11802) feat(core): Docusaurus Faster is stable + v4 future flag turns it on by default ([@slorber](https://github.com/slorber)) - `docusaurus-mdx-loader`, `docusaurus-utils`, `docusaurus` - [#11777](https://github.com/facebook/docusaurus/pull/11777) feat(cli): `write-heading-ids` CLI now supports the `--syntax` and `--migrate` options ([@slorber](https://github.com/slorber)) - `docusaurus-mdx-loader` - [#11755](https://github.com/facebook/docusaurus/pull/11755) feat(mdx-loader): add support for explicit `headingId` based on MD/MDX comments ([@slorber](https://github.com/slorber)) - `docusaurus-theme-live-codeblock`, `docusaurus-theme-translations` - [#11675](https://github.com/facebook/docusaurus/pull/11675) feat(theme-live-codeblock): reset button + wire `position` prop ([@NPX2218](https://github.com/NPX2218)) - `docusaurus-theme-classic`, `docusaurus-theme-common` - [#11734](https://github.com/facebook/docusaurus/pull/11734) feat(theme): Split ``, improve extensibility, better handling of emoji icons, stable classNames ([@slorber](https://github.com/slorber)) - [#11733](https://github.com/facebook/docusaurus/pull/11733) feat(theme): Use React context for ``, allow custom `` components ([@slorber](https://github.com/slorber)) - `docusaurus-faster`, `docusaurus` - [#11715](https://github.com/facebook/docusaurus/pull/11715) feat(bundler): upgrade to Rspack 1.7, remove useless experimental feature flags ([@slorber](https://github.com/slorber)) - `docusaurus-plugin-content-pages` - [#11666](https://github.com/facebook/docusaurus/pull/11666) feat(pages): add support for Markdown file path links ([@VedantMadane](https://github.com/VedantMadane)) - `docusaurus-mdx-loader`, `docusaurus-theme-classic` - [#11642](https://github.com/facebook/docusaurus/pull/11642) feat(mdx-loader): add admonitions directive support for class/id shortcuts ([@lebalz](https://github.com/lebalz)) - `docusaurus-theme-classic` - [#11635](https://github.com/facebook/docusaurus/pull/11635) feat(theme): add MDXComponents/Li to swizzle config ([@moskalakamil](https://github.com/moskalakamil)) - `docusaurus-t _[Truncated at 4000 characters — full notes: https://github.com/facebook/docusaurus/releases/tag/v3.10.0]_