# Docusaurus v3.8.0 — 3.8.0

- Product: Docusaurus (https://whatsnew.fyi/product/docusaurus)
- Vendor: Meta
- 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

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 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]_