# Docusaurus v3.9.0 — 3.9.0

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

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