# Docusaurus changelog

> A documentation site generator built on React, with versioning and search.

- Vendor: Meta
- Category: Developer Tools
- Official site: https://docusaurus.io
- Tracked by: What's New (https://whatsnew.fyi/product/docusaurus)
- Harvested from: GitHub (facebook/docusaurus)
- Entries below: 10 (newest first)

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'.

## Releases

### v3.10.2 — 3.10.2

- Date: 2026-07-10
- Version: v3.10.2
- Original notes: https://github.com/facebook/docusaurus/releases/tag/v3.10.2
- Permalink: https://whatsnew.fyi/product/docusaurus/releases/v3.10.2

- **fixed** — Bundler no longer imports @swc/html, fixing StackBlitz playground issues
- **fixed** — Core now uses locale URL in site config
- **fixed** — Theme-classic removes redundant sidebar label titles
- **fixed** — MDX-loader avoids transforming dotted directory links into assets
- **fixed** — Dev-server supports non-RSA TLS certificates for HTTPS
- **fixed** — Utils function extractLeadingEmoji() edge cases fixed
- **fixed** — StackBlitz support improved and @types/gtag.js vendored
- **fixed** — Create-docusaurus init template README uses npm commands by default
- **fixed** — CLI docusaurus serve command passes --host to server.listen()
- **fixed** — Core bumps detect-port to v2.1, fixing pnpm trustPolicy downgrade issue
- **changed** — Spanish translations completed for theme-common and theme-classic
- **changed** — Migrate to @11ty/gray-matter
- **security** — Core fixes BaseUrlIssueBanner security issue
- **fixed** — Core accepts boolean attributes in headTags config validation
- **fixed** — Sitemap no longer drops lastmod for epoch (0) timestamp
- **fixed** — Utils preserves author names containing commas in git log parsing

##### 3.10.2 (2026-07-10)

Backport and cherry-pick commits from main for v3.10.2 patch release:

- [fix(bundler): do not import `@swc/html`, fix StackBlitz playground \#12055](https://github.com/facebook/docusaurus/pull/12055)
- [fix(core): use locale url in site config \#12054](https://github.com/facebook/docusaurus/pull/12054)
- [fix(theme-classic): remove redundant sidebar label titles \#11966](https://github.com/facebook/docusaurus/pull/11966)
- [fix(mdx-loader): avoid transforming dotted directory links into asset… \#11944](https://github.com/facebook/docusaurus/pull/11944)
- [fix(dev-server): for HTTPS, support non-RSA TLS certs \#12065](https://github.com/facebook/docusaurus/pull/12065)
- [fix(utils): fix `extractLeadingEmoji()` edge cases \#12100](https://github.com/facebook/docusaurus/pull/12100)
- [fix(gtag.js, faster): Fix StackBlitz, vendor `@types/gtag.js`, upgrade `@swc/html` \#12080](https://github.com/facebook/docusaurus/pull/12080)
- [fix(create-docusaurus): init template README should use npm commands by default \#12138](https://github.com/facebook/docusaurus/pull/12138)
- [fix(cli): `docusaurus serve` should pass `--host` to `server.listen()` \#12127](https://github.com/facebook/docusaurus/pull/12127)
- [fix(core): bump detect-port to v2.1, fix pnpm `trustPolicy` downgrade issue \#12012](https://github.com/facebook/docusaurus/pull/12012)
- [fix(i18n): complete Spanish translations for theme-common and theme-l… \#12180](https://github.com/facebook/docusaurus/pull/12180)
- [chore(deps): migrate to `@11ty/gray-matter` \#12181](https://github.com/facebook/docusaurus/pull/12181)
- [fix(core): fix BaseUrlIssueBanner little security issue \#12260](https://github.com/facebook/docusaurus/pull/12260)
- [fix(core): accept boolean attributes in headTags config validation \#12238](https://github.com/facebook/docusaurus/pull/12238)
- [fix(sitemap): don't drop lastmod for an epoch (0) timestamp \#12212](https://github.com/facebook/docusaurus/pull/12212)
- [fix(utils): preserve author names containing commas in git log parsing \#12069](https://github.com/facebook/docusaurus/pull/12069)

### v3.10.1 — 3.10.1

- Date: 2026-04-30
- Version: v3.10.1
- Original notes: https://github.com/facebook/docusaurus/releases/tag/v3.10.1
- Permalink: https://whatsnew.fyi/product/docusaurus/releases/v3.10.1

- **fixed** — Fix v3 webpackbar bug due to webpack breaking change

##### 3.10.1 (2026-04-30)

###### :bug: Bug Fix

- `docusaurus-bundler`
  - [#11981](https://github.com/facebook/docusaurus/pull/11981) fix(bundler): fix v3 webpackbar bug due to webpack breaking change ([@slorber](https://github.com/slorber))

###### :wrench: Maintenance

- `docusaurus`
  - [#11982](https://github.com/facebook/docusaurus/pull/11982) chore: cherry-pick commits for v3.10.1 patch release ([@slorber](https://github.com/slorber))

###### Committers: 1

- Sébastien Lorber ([@slorber](https://github.com/slorber))

### v3.10.0 — 3.10.0

- 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

- **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 `<DocCard>`, improve extensibility, better handling of emoji icons, and stabilize classNames
- **changed** — Use React context for `<Tabs>` and allow custom `<TabItem>` 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 `<DocCard>`, 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 `<Tabs>`, allow custom `<TabItem>` 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]_

### v3.9.2 — 3.9.2

- Date: 2025-10-17
- Version: v3.9.2
- Original notes: https://github.com/facebook/docusaurus/releases/tag/v3.9.2
- Permalink: https://whatsnew.fyi/product/docusaurus/releases/v3.9.2

- **fixed** — Add support for missing `sidebar_key` front matter attribute in docs plugin
- **fixed** — Disable CSS counter minification in cssnano preset
- **fixed** — Fix Algolia AskAI validation logic in theme-search-algolia
- **fixed** — Add missing Polish (pl) theme translations
- **fixed** — Fix CSS `scroll-margin-top` when clicking footnote items
- **fixed** — Allow `i18n.localeConfigs.translate` in validation
- **fixed** — Fix Mermaid ELK layout dependency required bug on v3.9
- **changed** — Lazy load the Mermaid library
- **fixed** — Remove "Edit this page" button from print view
- **changed** — Improve Arabic theme translations

##### 3.9.2 (2025-10-17)

###### :bug: Bug Fix

- `docusaurus-plugin-content-docs`
  - [#11490](https://github.com/facebook/docusaurus/pull/11490) fix(docs): add support for missing `sidebar_key` front matter attribute ([@slorber](https://github.com/slorber))
- `docusaurus-cssnano-preset`
  - [#11487](https://github.com/facebook/docusaurus/pull/11487) fix(cssnano-preset): disable CSS counter minification ([@YDKK](https://github.com/YDKK))
- `docusaurus-theme-search-algolia`
  - [#11468](https://github.com/facebook/docusaurus/pull/11468) fix(theme-search-algolia): Fix Algolia AskAI validation logic ([@slorber](https://github.com/slorber))
- `docusaurus-theme-translations`
  - [#11431](https://github.com/facebook/docusaurus/pull/11431) fix(theme-translation): add missing Polish (pl) theme translations ([@mariuszkrzaczkowski](https://github.com/mariuszkrzaczkowski))
- `docusaurus-theme-classic`, `docusaurus-theme-common`
  - [#11466](https://github.com/facebook/docusaurus/pull/11466) fix(theme): Fix CSS `scroll-margin-top` when clicking footnote items, factorize code ([@slorber](https://github.com/slorber))
- `docusaurus`
  - [#11452](https://github.com/facebook/docusaurus/pull/11452) fix(core): allow `i18n.localeConfigs.translate` in validation ([@trofim24](https://github.com/trofim24))
- `docusaurus-theme-mermaid`
  - [#11437](https://github.com/facebook/docusaurus/pull/11437) fix(theme-mermaid): Fix Mermaid ELK layout dependency required bug on v3.9 ([@slorber](https://github.com/slorber))

###### :running_woman: Performance

- `docusaurus-theme-mermaid`
  - [#11438](https://github.com/facebook/docusaurus/pull/11438) perf(theme-mermaid): lazy load the Mermaid library ([@slorber](https://github.com/slorber))

###### :nail_care: Polish

- `docusaurus-theme-classic`
  - [#11463](https://github.com/facebook/docusaurus/pull/11463) fix(theme): remove "Edit this page" button from print view ([@richk21](https://github.com/richk21))

###### :robot: Dependencies

- [#11479](https://github.com/facebook/docusaurus/pull/11479) chore(deps): bump stefanzweifel/git-auto-commit-action from 6 to 7 ([@dependabot[bot]](https://github.com/apps/dependabot))
- [#11480](https://github.com/facebook/docusaurus/pull/11480) chore(deps): bump github/codeql-action from 3.26.5 to 4.30.8 ([@dependabot[bot]](https://github.com/apps/dependabot))
- [#11481](https://github.com/facebook/docusaurus/pull/11481) chore(deps): bump actions/dependency-review-action from 4.8.0 to 4.8.1 ([@dependabot[bot]](https://github.com/apps/dependabot))
- [#11446](https://github.com/facebook/docusaurus/pull/11446) chore(deps): bump actions/dependency-review-action from 4.7.3 to 4.8.0 ([@dependabot[bot]](https://github.com/apps/dependabot))

###### :globe_with_meridians: Translations

- `docusaurus-theme-translations`
  - [#11484](https://github.com/facebook/docusaurus/pull/11484) fix(translations): improve Arabic theme translations ([@maysara-elshewehy](https://github.com/maysara-elshewehy))

###### Committers: 9

- Alexander Trofimov ([@trofim24](https://github.com/trofim24))
- Dan Roscigno ([@DanRoscigno](https://github.com/DanRoscigno))
- Eleni Grosdouli ([@egrosdou01](https://github.com/egrosdou01))
- Ethan ([@ethanppl](https://github.com/ethanppl))
- Mariusz Krzaczkowski ([@mariuszkrzaczkowski](https://github.com/mariuszkrzaczkowski))
- Maysara ([@maysara-elshewehy](https://github.com/maysara-elshewehy))
- Richa Kiran ([@richk21](https://github.com/richk21))
- Sébastien Lorber ([@slorber](https://github.com/slorber))
- [@YDKK](https://github.com/YDKK)

### v3.9.1 — 3.9.1

- Date: 2025-09-26
- Version: v3.9.1
- Original notes: https://github.com/facebook/docusaurus/releases/tag/v3.9.1
- Permalink: https://whatsnew.fyi/product/docusaurus/releases/v3.9.1

- **fixed** — Fix Docusaurus outDir for sites using baseUrl

##### 3.9.1 (2025-09-26)

###### :bug: Bug Fix

- `docusaurus`
  - [#11434](https://github.com/facebook/docusaurus/pull/11434) fix(core): fix Docusaurus outDir for sites using baseUrl ([@slorber](https://github.com/slorber))

###### Committers: 1

- Sébastien Lorber ([@slorber](https://github.com/slorber))

### v3.9.0 — 3.9.0

- Date: 2025-09-25
- Version: v3.9.0
- Original notes: https://github.com/facebook/docusaurus/releases/tag/v3.9.0
- Permalink: https://whatsnew.fyi/product/docusaurus/releases/v3.9.0

- **added** — Use DocSearch v4.1 with optimized integration in theme-search-algolia
- **added** — Add support for email social icon in blog and resize default social icon
- **added** — Add theme-tabs-container stable className to theme
- **added** — Add runtime support for DocSearch v4
- **changed** — Upgrade Rspack to 1.5 and use lazyBarrel experiment
- **changed** — Upgrade Rspack to 1.4 in faster plugin
- **added** — Resolve @site/* markdown links and fix resolution priority bugs
- **added** — Support elk layout in mermaid theme
- **added** — Add i18n.localeConfigs[locale].{url,baseUrl} config options to fix multi-domain deployments
- **added** — Add i18n.localeConfigs.translate option and skip translation process if i18n/<locale> dir doesn't exist
- **added** — Add sidebar item key attribute to fix docs translations key conflicts
- **changed** — Use respectPrefersColorScheme in create-docusaurus init template
- **added** — Add siteConfig.markdown.emoji config option to disable remark-emoji
- **added** — Add siteConfig.markdown.hooks config option
- **deprecated** — Deprecate siteConfig.onBrokenMarkdownLinks
- **fixed** — Fix copy of indented code blocks and replace copy-text-to-clipboard by clipboard API
- **fixed** — Remove hardcoded fill from Bluesky and LinkedIn icons
- **fixed** — Render sidebar category index with unlisted children as a simple doc/link item
- **fixed** — Add translate no to heading anchors and blog authors
- **fixed** — Doc sidebar links and categories with long labels should display properly

##### 3.9.0 (2025-09-25)

###### :rocket: New Feature

- `docusaurus-theme-search-algolia`
  - [#11421](https://github.com/facebook/docusaurus/pull/11421) feat(theme-search-algolia): use DocSearch v4.1, optimize integration ([@slorber](https://github.com/slorber))
- `docusaurus-plugin-content-blog`, `docusaurus-theme-classic`
  - [#11425](https://github.com/facebook/docusaurus/pull/11425) feat(blog): Add support for email social icon + resize default social icon a bit ([@slorber](https://github.com/slorber))
- `docusaurus-theme-classic`, `docusaurus-theme-common`
  - [#11426](https://github.com/facebook/docusaurus/pull/11426) feat(theme): Add theme-tabs-container stable className ([@slorber](https://github.com/slorber))
- `docusaurus-theme-classic`, `docusaurus-theme-search-algolia`, `docusaurus-theme-translations`
  - [#11327](https://github.com/facebook/docusaurus/pull/11327) feat(search): add runtime support for DocSearch v4 ([@dylantientcheu](https://github.com/dylantientcheu))
- `docusaurus-faster`, `docusaurus`
  - [#11415](https://github.com/facebook/docusaurus/pull/11415) feat(faster): upgrade Rspack to 1.5, use lazyBarrel experiment, remove deprecated option ([@slorber](https://github.com/slorber))
  - [#11294](https://github.com/facebook/docusaurus/pull/11294) feat(faster): Upgrade to Rspack 1.4 ([@slorber](https://github.com/slorber))
- `docusaurus-utils`
  - [#11397](https://github.com/facebook/docusaurus/pull/11397) feat(mdx): resolve `@site/*` markdown links, fix resolution priority bugs ([@slorber](https://github.com/slorber))
- `docusaurus-theme-mermaid`
  - [#11357](https://github.com/facebook/docusaurus/pull/11357) feat(mermaid): support elk layout ([@Feez2403](https://github.com/Feez2403))
- `docusaurus-plugin-pwa`, `docusaurus-theme-classic`, `docusaurus-theme-common`, `docusaurus-types`, `docusaurus-utils`, `docusaurus`
  - [#11316](https://github.com/facebook/docusaurus/pull/11316) feat(core): Add `i18n.localeConfigs[locale].{url,baseUrl}` config options, fix multi-domain deployments ([@slorber](https://github.com/slorber))
- `docusaurus-plugin-content-blog`, `docusaurus-plugin-content-docs`, `docusaurus-plugin-content-pages`, `docusaurus-types`, `docusaurus-utils`, `docusaurus`
  - [#11304](https://github.com/facebook/docusaurus/pull/11304) feat(core): add `i18n.localeConfigs.translate` + skip translation process if `i18n/<locale>` dir doesn't exist ([@slorber](https://github.com/slorber))
- `docusaurus-plugin-content-docs`
  - [#11228](https://github.com/facebook/docusaurus/pull/11228) feat(docs): sidebar item `key` attribute - fix docs translations key conflicts ([@slorber](https://github.com/slorber))
- `create-docusaurus`
  - [#11293](https://github.com/facebook/docusaurus/pull/11293) feat(create-docusaurus): use respectPrefersColorScheme in init template ([@slorber](https://github.com/slorber))
- `docusaurus-mdx-loader`, `docusaurus-types`, `docusaurus`
  - [#11282](https://github.com/facebook/docusaurus/pull/11282) feat(core): add `siteConfig.markdown.emoji` config option to disable `remark-emoji` ([@slorber](https://github.com/slorber))
- `create-docusaurus`, `docusaurus-mdx-loader`, `docusaurus-plugin-content-blog`, `docusaurus-plugin-content-docs`, `docusaurus-types`, `docusaurus`
  - [#11283](https://github.com/facebook/docusaurus/pull/11283) feat(core): Add `siteConfig.markdown.hooks`, deprecate `siteConfig.onBrokenMarkdownLinks` ([@slorber](https://github.com/slorber))

###### :bug: Bug Fix

- `docusaurus-theme-classic`, `docusaurus`
  - [#11422](https://github.com/facebook/docusaurus/pull/11422) fix(theme): fix copy of indented code blocks, replace copy-text-to-clipboard by clipboard API ([@slorber](https://github.com/slorber))
- `docusaurus-theme-classic`
  - [#11407](https://github.com/facebook/docusaurus/pull/11407) fix(theme): remove hardcoded fill from Bluesky and LinkedIn icons ([@Simek](https://github.com/Simek))
  - [#11389](https://github.com/fa

_[Truncated at 4000 characters — full notes: https://github.com/facebook/docusaurus/releases/tag/v3.9.0]_

### v3.8.1 — 3.8.1

- Date: 2025-06-06
- Version: v3.8.1
- Original notes: https://github.com/facebook/docusaurus/releases/tag/v3.8.1
- Permalink: https://whatsnew.fyi/product/docusaurus/releases/v3.8.1

- **fixed** — Fix inability to navigate to category's page when browsing its children items in theme
- **fixed** — Fix Windows CSS cascade layers bug
- **fixed** — Fix docusaurus start using concatenateModules: true
- **fixed** — Include Arc to supported Chromium browsers
- **fixed** — Fix docusaurus start error for macOS users with no Chromium-based browser
- **fixed** — Fix future flags public types
- **changed** — Avoid duplicated git log calls in loadContent() and postBuild() for untracked Git files

###### :bug: Bug Fix

- `docusaurus-theme-classic`
  - [#11242](https://github.com/facebook/docusaurus/pull/11242) fix(theme): fix unability to navigate to category's page when browsing its children items ([@slorber](https://github.com/slorber))
- `docusaurus-plugin-css-cascade-layers`
  - [#11241](https://github.com/facebook/docusaurus/pull/11241) fix(css-cascade-layers): fix windows css cascade layers bug ([@slorber](https://github.com/slorber))
- `docusaurus`
  - [#11222](https://github.com/facebook/docusaurus/pull/11222) fix(bundler): fix `docusaurus start` using `concatenateModules: true` ([@slorber](https://github.com/slorber))
  - [#11217](https://github.com/facebook/docusaurus/pull/11217) fix: include Arc to supported Chromium Browsers ([@wellwelwel](https://github.com/wellwelwel))
  - [#11205](https://github.com/facebook/docusaurus/pull/11205) fix(core): fix `docusaurus start` error for macOS users with no Chromium-based browser ([@slorber](https://github.com/slorber))
- `docusaurus-types`
  - [#11221](https://github.com/facebook/docusaurus/pull/11221) fix(types): fix future flags public types ([@slorber](https://github.com/slorber))

###### :running_woman: Performance

- `docusaurus-plugin-content-blog`, `docusaurus-plugin-sitemap`, `docusaurus-theme-classic`, `docusaurus-types`, `docusaurus-utils`, `docusaurus`
  - [#11211](https://github.com/facebook/docusaurus/pull/11211) perf: avoid duplicated `git log` calls in `loadContent()` and `postBuild()` for untracked Git files ([@slorber](https://github.com/slorber))

###### :wrench: Maintenance

- `docusaurus-faster`
  - [#11248](https://github.com/facebook/docusaurus/pull/11248) chore(faster): upgrade Rspack ([@slorber](https://github.com/slorber))
- `docusaurus-plugin-content-docs`
  - [#11230](https://github.com/facebook/docusaurus/pull/11230) refactor(docs): extract `loadVersion()` without changing the behavior ([@slorber](https://github.com/slorber))
- Other
  - [#11212](https://github.com/facebook/docusaurus/pull/11212) chore: upgrade to Node 22 by default ([@slorber](https://github.com/slorber))

###### Committers: 7

- Ben McCann ([@benmccann](https://github.com/benmccann))
- Dave Meyer ([@dave-meyer](https://github.com/dave-meyer))
- Léo Vincent ([@leovct](https://github.com/leovct))
- Noritaka Kobayashi ([@noritaka1166](https://github.com/noritaka1166))
- Phil Parsons ([@p-m-p](https://github.com/p-m-p))
- Sébastien Lorber ([@slorber](https://github.com/slorber))
- Weslley Araújo ([@wellwelwel](https://github.com/wellwelwel))

### v3.8.0 — 3.8.0

- Date: 2025-05-27
- Version: v3.8.0
- Original notes: https://github.com/facebook/docusaurus/releases/tag/v3.8.0
- Permalink: https://whatsnew.fyi/product/docusaurus/releases/v3.8.0

- **added** — Add new CSS cascade layers plugin with built-in v4.useCssCascadeLayers future flag
- **added** — Add internal flag to skip bundling in core
- **added** — Enable Rspack parallelCodeSplitting
- **added** — Make it possible to provide your own page title formatter
- **added** — Support frontMatter.slug in pages plugin like docs and blog plugins
- **added** — Add bundler tracing and profiling
- **added** — Allow resetting colorMode to System or OS value
- **added** — Add Bun to default tabs conversions in npm2yarn plugin
- **added** — Add theme layout stable CSS classes
- **added** — Add code block showLineNumbers=start metastring
- **added** — Implement Docusaurus Faster with Rspack Persistent Cache
- **added** — Add versions attribute to docsVersionDropdown navbar item
- **added** — Implement Docusaurus Faster with SSG worker threads
- **added** — Add new postBuild({routesBuildMetadata}) API and deprecate head attribute with v4 future flag
- **fixed** — Replace reading-time with Intl.Segmenter API in content-blog plugin
- **fixed** — Fix blog Atom feed item url and XSL bug
- **fixed** — Remove opt-in for mdx dependency file in mdx-loader
- **fixed** — Fix versioning CLI to copy localized translation file current.json to version-<v>.json
- **fixed** — Restore former code block theme-common internal APIs
- **fixed** — Fix code block magic comments with CRLF line breaks bug

##### 3.8.0 (2025-05-26)

###### :rocket: New Feature

- `docusaurus-plugin-css-cascade-layers`, `docusaurus-preset-classic`, `docusaurus-theme-classic`, `docusaurus-types`, `docusaurus`
  - [#11142](https://github.com/facebook/docusaurus/pull/11142) feat(theme): new CSS cascade layers plugin + built-in `v4.useCssCascadeLayers` future flag ([@slorber](https://github.com/slorber))
- `docusaurus`
  - [#11156](https://github.com/facebook/docusaurus/pull/11156) feat(core): add internal flag to skip bundling ([@slorber](https://github.com/slorber))
  - [#11067](https://github.com/facebook/docusaurus/pull/11067) feat(core): enable Rspack `parallelCodeSplitting` ([@slorber](https://github.com/slorber))
- `docusaurus-module-type-aliases`, `docusaurus-plugin-content-blog`, `docusaurus-theme-classic`, `docusaurus-theme-common`, `docusaurus-theme-search-algolia`, `docusaurus`
  - [#11090](https://github.com/facebook/docusaurus/pull/11090) feat(theme): make it possible to provide your own page title formatter ([@slorber](https://github.com/slorber))
- `docusaurus-plugin-content-pages`
  - [#11088](https://github.com/facebook/docusaurus/pull/11088) feat(pages): Support `frontMatter.slug` like docs and blog plugins ([@slorber](https://github.com/slorber))
- `docusaurus-faster`, `docusaurus`
  - [#11006](https://github.com/facebook/docusaurus/pull/11006) feat(core): Add bundler tracing/profiling ([@slorber](https://github.com/slorber))
- `docusaurus-theme-classic`, `docusaurus-theme-common`, `docusaurus-theme-translations`
  - [#10987](https://github.com/facebook/docusaurus/pull/10987) feat(theme): Allow resetting colorMode to System/OS value ([@slorber](https://github.com/slorber))
- `docusaurus-remark-plugin-npm2yarn`
  - [#10953](https://github.com/facebook/docusaurus/pull/10953) feat(plugin-npm2yarn): Add Bun to default tabs conversions ([@jakeboone02](https://github.com/jakeboone02))
- `docusaurus-theme-classic`, `docusaurus-theme-common`
  - [#10945](https://github.com/facebook/docusaurus/pull/10945) feat(theme): add theme layout stable CSS classes ([@slorber](https://github.com/slorber))
  - [#10846](https://github.com/facebook/docusaurus/pull/10846) feat(theme): code block showLineNumbers=start metastring ([@slorber](https://github.com/slorber))
- `docusaurus-faster`, `docusaurus-plugin-content-docs`, `docusaurus-types`, `docusaurus`
  - [#10931](https://github.com/facebook/docusaurus/pull/10931) feat(core): Docusaurus Faster - Rspack Persistent Cache ([@slorber](https://github.com/slorber))
- `docusaurus-theme-classic`
  - [#10852](https://github.com/facebook/docusaurus/pull/10852) feat(theme): add `versions` attribute to `docsVersionDropdown` navbar item ([@hrumhurum](https://github.com/hrumhurum))
- `docusaurus-types`, `docusaurus`
  - [#10826](https://github.com/facebook/docusaurus/pull/10826) feat(core): Docusaurus Faster - SSG worker threads ([@slorber](https://github.com/slorber))
- `docusaurus-plugin-sitemap`, `docusaurus-types`, `docusaurus`
  - [#10850](https://github.com/facebook/docusaurus/pull/10850) feat(core): new `postBuild({routesBuildMetadata})` API, deprecate `head` attribute + v4 future flag ([@slorber](https://github.com/slorber))

###### :bug: Bug Fix

- `docusaurus-plugin-content-blog`
  - [#11138](https://github.com/facebook/docusaurus/pull/11138) refactor(content-blog): replace `reading-time` with `Intl.Segmenter` API ([@shreedharbhat98](https://github.com/shreedharbhat98))
- `docusaurus-plugin-content-blog`
  - [#11138](https://github.com/facebook/docusaurus/pull/11138) refactor(content-blog): replace `reading-time` with `Intl.Segmenter` API ([@shreedharbhat98](https://github.com/shreedharbhat98))
  - [#11068](https://github.com/facebook/docusaurus/pull/11068) fix(blog): fix blog Atom feed item url / XSL bug ([@slorber](https://github.com/slorber))
- `docusaurus-plugin-content-docs`
  - [#11179](https://github.com/facebook/docusaurus/pull/11179) fix(mdx-loader): remove

_[Truncated at 4000 characters — full notes: https://github.com/facebook/docusaurus/releases/tag/v3.8.0]_

### v3.7.0 — 3.7.0

- Date: 2025-01-03
- Version: v3.7.0
- Original notes: https://github.com/facebook/docusaurus/releases/tag/v3.7.0
- Permalink: https://whatsnew.fyi/product/docusaurus/releases/v3.7.0

- **added** — Turn Rspack incremental on by default
- **added** — Add author social icons for bluesky, mastodon, threads, twitch, youtube, and instagram in blog posts
- **added** — Add React 19 support to Docusaurus v3
- **added** — Add frontMatter.sidebar_label option for blog posts
- **added** — Create new Docusaurus SVGR plugin
- **fixed** — Add missing npm-to-yarn converter for Bun
- **fixed** — Footer Column/Link should merge provided className
- **fixed** — Fix React hydration errors and change html minifier settings
- **fixed** — Code block magic comments should support SQL block comments
- **fixed** — Add missing Dutch (nl) theme translations
- **fixed** — Add missing Korean (ko) theme translations
- **fixed** — Fix sidebar item visibility bug for category index
- **fixed** — Fix codegen routesChunkName possible hash collision
- **fixed** — Fix markdown image paths with spaces bug related to transformImage encoding problem
- **changed** — Use Intl native API to get locale direction and remove rtl-detect dependency
- **changed** — Upgrade algoliasearch to v5

##### 3.7.0 (2025-01-03)

###### :rocket: New Feature
* `docusaurus-faster`, `docusaurus`
  * [#10800](https://github.com/facebook/docusaurus/pull/10800) feat(core): Turn Rspack incremental on by default (again) ([@slorber](https://github.com/slorber))
* `docusaurus-plugin-content-blog`, `docusaurus-theme-classic`
  * [#10768](https://github.com/facebook/docusaurus/pull/10768) feat(blog): Add author social icons for bluesky, mastodon, threads, twitch, youtube, instagram ([@GingerGeek](https://github.com/GingerGeek))
* `create-docusaurus`, `docusaurus-mdx-loader`, `docusaurus-module-type-aliases`, `docusaurus-plugin-client-redirects`, `docusaurus-plugin-content-blog`, `docusaurus-plugin-content-docs`, `docusaurus-plugin-content-pages`, `docusaurus-plugin-debug`, `docusaurus-plugin-google-analytics`, `docusaurus-plugin-google-gtag`, `docusaurus-plugin-google-tag-manager`, `docusaurus-plugin-ideal-image`, `docusaurus-plugin-pwa`, `docusaurus-plugin-rsdoctor`, `docusaurus-plugin-sitemap`, `docusaurus-plugin-svgr`, `docusaurus-plugin-vercel-analytics`, `docusaurus-preset-classic`, `docusaurus-theme-classic`, `docusaurus-theme-common`, `docusaurus-theme-live-codeblock`, `docusaurus-theme-mermaid`, `docusaurus-theme-search-algolia`, `docusaurus-types`, `docusaurus`
  * [#10763](https://github.com/facebook/docusaurus/pull/10763) feat: Add React 19 support to Docusaurus v3 ([@slorber](https://github.com/slorber))
* `docusaurus-plugin-content-blog`
  * [#10729](https://github.com/facebook/docusaurus/pull/10729) feat(blog): Add `frontMatter.sidebar_label`  ([@slorber](https://github.com/slorber))
* `docusaurus-module-type-aliases`, `docusaurus-plugin-svgr`, `docusaurus-preset-classic`, `docusaurus-types`, `docusaurus-utils`, `docusaurus`
  * [#10677](https://github.com/facebook/docusaurus/pull/10677) feat(svgr): create new Docusaurus SVGR plugin ([@slorber](https://github.com/slorber))

###### :bug: Bug Fix
* `docusaurus-remark-plugin-npm2yarn`
  * [#10803](https://github.com/facebook/docusaurus/pull/10803) fix(npm-to-yarn): add missing npm-to-yarn converter for Bun ([@Lehoczky](https://github.com/Lehoczky))
* `docusaurus-theme-classic`, `docusaurus-theme-common`
  * [#10796](https://github.com/facebook/docusaurus/pull/10796) fix(theme): Footer Column/Link should merge provided className ([@slorber](https://github.com/slorber))
* `docusaurus-bundler`, `docusaurus-theme-common`
  * [#10786](https://github.com/facebook/docusaurus/pull/10786) fix(core): fix React hydration errors, change html minifier settings ([@slorber](https://github.com/slorber))
* `docusaurus-theme-common`
  * [#10782](https://github.com/facebook/docusaurus/pull/10782) fix(theme-common): code block magic comments should support SQL block comments ([@WillBlack403](https://github.com/WillBlack403))
* `docusaurus-theme-translations`
  * [#10783](https://github.com/facebook/docusaurus/pull/10783) fix(theme-translations): Add missing Dutch (nl) theme translations ([@janaukema](https://github.com/janaukema))
  * [#10760](https://github.com/facebook/docusaurus/pull/10760) fix(theme-translation): add missing Korean (ko) theme translations ([@effozen](https://github.com/effozen))
* `docusaurus-plugin-content-docs`
  * [#10754](https://github.com/facebook/docusaurus/pull/10754) fix(docs): fix sidebar item visibility bug for category index ([@slorber](https://github.com/slorber))
* `docusaurus`
  * [#10727](https://github.com/facebook/docusaurus/pull/10727) fix(core): fix codegen routesChunkName possible hash collision  ([@slorber](https://github.com/slorber))
* `docusaurus-mdx-loader`
  * [#10723](https://github.com/facebook/docusaurus/pull/10723) fix(mdx-loader): fix md image paths with spaces bug related to transformImage encoding problem ([@slorber](https://github.com/slorber))

###### :memo: Documentation
* [#10740](https://github.com/facebook/docusaurus/pull/10740) docs: Link initialization docs together ([@waldyrious](https://github.com/wa

_[Truncated at 4000 characters — full notes: https://github.com/facebook/docusaurus/releases/tag/v3.7.0]_

### v3.6.3 — 3.6.3

- Date: 2024-11-22
- Version: v3.6.3
- Original notes: https://github.com/facebook/docusaurus/releases/tag/v3.6.3
- Permalink: https://whatsnew.fyi/product/docusaurus/releases/v3.6.3

- **fixed** — Disable Rspack incremental in dev mode to resolve development build issues

##### 3.6.3 (2024-11-22)

###### :bug: Bug Fix

- `docusaurus`
  - [#10712](https://github.com/facebook/docusaurus/pull/10712) fix(core): disable Rspack incremental in dev ([@slorber](https://github.com/slorber))