Skip to content

Releases: facebook/docusaurus

3.9.2

17 Oct 15:01

Choose a tag to compare

3.9.2 (2025-10-17)

🐛 Bug Fix

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

🏃‍♀️ Performance

  • docusaurus-theme-mermaid
    • #11438 perf(theme-mermaid): lazy load the Mermaid library (@slorber)

💅 Polish

  • docusaurus-theme-classic
    • #11463 fix(theme): remove "Edit this page" button from print view (@richk21)

🤖 Dependencies

🌐 Translations

Committers: 9

3.9.1

26 Sep 13:16

Choose a tag to compare

3.9.1 (2025-09-26)

🐛 Bug Fix

  • docusaurus
    • #11434 fix(core): fix Docusaurus outDir for sites using baseUrl (@slorber)

Committers: 1

3.9.0

25 Sep 15:54

Choose a tag to compare

3.9.0 (2025-09-25)

🚀 New Feature

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

🐛 Bug Fix

  • docusaurus-theme-classic, docusaurus
    • #11422 fix(theme): fix copy of indented code blocks, replace copy-text-to-clipboard by clipboard API (@slorber)
  • docusaurus-theme-classic
    • #11407 fix(theme): remove hardcoded fill from Bluesky and LinkedIn icons (@Simek)
    • #11389 fix(theme): render sidebar category index with unlisted children as a simple doc/link item (@slorber)
    • #11360 fix(theme): Add translate no to heading anchors and blog authors (@slorber)
    • #11356 fix(theme): Doc sidebar links/categories with long labels should display properly (@slorber)
    • #11338 fix(theme-classic): fix collapsed sidebar category expansion when navigating to another link within that category (@qqq614)
    • #11289 fix(theme): Fix footnote ref scrolling behind the navbar when footnote back reference clicked (@slorber)
  • docusaurus
    • #11410 fix(deps): upgrade webpack-dev-server to v5, fix security warning (@slorber)
    • #11347 fix(core): Fix docusaurus start on macOS when exec throws a synchronous error (@slorber)
    • #11271 fix(dev-server): use correct dev server HTML lang attribute (@enumura1)
  • docusaurus-theme-common
    • #11405 fix(theme): fix useColorMode() visual glitches due to provider unmounts/remounts (@slorber)
    • #11280 fix(theme-common): Export FooterColumnItem type (@stubinubin)
  • docusaurus-bundler, docusaurus-faster
    • #11383 fix(ssg): HTML minifier should preserve <head> for og:image crawlers (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-translations
    • #11331 fix(theme): Add aria-label to IconExternalLink with value '(opens in new tab)' (@WestonThayer)
  • docusaurus-plugin-content-docs
    • #11281 fix(docs): Fix empty sidebar item category className lost when post-processed to a doc (@slorber)
    • #11251 fix(docs): prevent docs ids conflicts within a version (@slorber)
  • docusaurus-theme-classic, docusaurus-theme-common
    • #11263 fix(theme): make useHistorySelector() hydration-safe + use it read search/hash in theme (@slorber)

📝 Documentation

🤖 Dependencies

🔧 Maintenance

  • create-docusaurus, docusaurus-babel, docusaurus-bundler, docusaurus-cssnano-preset, docusaurus-faster, docusaurus-logger, docusaurus-mdx-loader, docusaurus-plugin-client-redirects, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-css-cascade-layers, 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-remark-plugin-npm2yarn, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-live-codeblock, docusaurus-theme-mermaid, docusaurus-theme-search-algolia, docusaurus-theme-translations, `docusa...
Read more

3.8.1

06 Jun 15:34

Choose a tag to compare

🐛 Bug Fix

  • docusaurus-theme-classic
    • #11242 fix(theme): fix unability to navigate to category's page when browsing its children items (@slorber)
  • docusaurus-plugin-css-cascade-layers
    • #11241 fix(css-cascade-layers): fix windows css cascade layers bug (@slorber)
  • docusaurus
    • #11222 fix(bundler): fix docusaurus start using concatenateModules: true (@slorber)
    • #11217 fix: include Arc to supported Chromium Browsers (@wellwelwel)
    • #11205 fix(core): fix docusaurus start error for macOS users with no Chromium-based browser (@slorber)
  • docusaurus-types

🏃‍♀️ Performance

  • docusaurus-plugin-content-blog, docusaurus-plugin-sitemap, docusaurus-theme-classic, docusaurus-types, docusaurus-utils, docusaurus
    • #11211 perf: avoid duplicated git log calls in loadContent() and postBuild() for untracked Git files (@slorber)

🔧 Maintenance

  • docusaurus-faster
  • docusaurus-plugin-content-docs
    • #11230 refactor(docs): extract loadVersion() without changing the behavior (@slorber)
  • Other

Committers: 7

3.8.0

27 May 10:08

Choose a tag to compare

3.8.0 (2025-05-26)

🚀 New Feature

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

🐛 Bug Fix

  • docusaurus-plugin-content-blog
  • docusaurus-plugin-content-blog
  • docusaurus-plugin-content-docs
    • #11179 fix(mdx-loader): remove opt-in for mdx dependency file (@slorber)
    • #10875 fix(docs): versioning CLI should copy localized translation file current.json to version-<v>.json (@jkboxomine)
  • create-docusaurus
    • #11157 fix(create-docusaurus): Improve init template README, fix headings and remove $ in bash code blocks (@arienshibani)
  • docusaurus-theme-common
    • #11153 fix(theme): restore former code block theme-common internal APIs (@slorber)
    • #11046 fix(theme): Fix code block magic comments with CRLF line breaks bug (@coder-xiaomo)
    • #10989 fix(theme): mobile drawer history blocker should be rendered conditionally (workaround) (@slorber)
    • #10954 fix(theme): fix useColorMode().colorMode leading to React hydration mismatches (@slorber)
  • docusaurus-theme-classic
    • #11085 fix(theme): add missing rel="tag" attribute for docs/blog tags (@slorber)
    • #10999 fix(theme): CodeBlock should accept title of ReactNode type (@lebalz)
    • #10705 fix(theme): only render secondaryMenu if it should be shown (@hidde)
    • #10898 fix(theme): a11y fix on mobile DropdownNavbarItem (@mxschmitt)
    • #10909 fix(theme): apply docs sidebar_class_name in DocCard + better dogfooding (@slorber)
    • #10849 fix(theme): fix <DocCard> height inconsistency (@hichemfantar)
    • #10866 fix(theme): Hide code block buttons before React hydration (@kennethormandy)
  • docusaurus-theme-classic, docusaurus-theme-translations
    • #11053 fix(theme): navbar mobile sidebar should allow clicking dropdown parent link (@slorber)
  • docusaurus-utils
  • docusaurus-theme-translations
  • docusaurus-plugin-ideal-image
    • #11026 fix(ideal-image): fix waypoint initial scroll bug (@slorber)
    • #11014 fix(ideal-image): Internalize react-waypoint dependency, fix React 19 compatibility (@slorber)
    • #10910 fix(ideal-image): Add issuer to ideal-image Webpack loader (@slorber)
  • docusaurus-mdx-loader
    • #11004 fix(mdx-loader): refactor and fix heading to toc html value serialization (@slorber)
  • docusaurus-module-type-aliases
  • docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-translations
    • #10987 feat(theme): Allow resetting colorMode to System/OS value (@slorber)
  • create-docusaurus, docusaurus-utils
    • #10958 fix(create-docusaurus): fix CLI and remove shelljs escapeShellArg util (@slorber)
  • docusaurus-mdx-loader, docusaurus-plugin-content-docs
    • #10934 fix(docs): fix mdx loader cache invalidation bug on versions changes (@slorber)
  • docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages
  • docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-theme-classic, docusaurus-theme-common
    • #10888 fix(seo): docs breadcrumb structured data should use JSON-LD and filter unliked categories (@johnnyreilly)
  • docusaurus-theme-classic, docusaurus-theme-common
    • #10886 fix(theme): collapse doc sidebar category on label click if active ...
Read more

3.7.0

03 Jan 18:02

Choose a tag to compare

3.7.0 (2025-01-03)

🚀 New Feature

  • docusaurus-faster, docusaurus
    • #10800 feat(core): Turn Rspack incremental on by default (again) (@slorber)
  • docusaurus-plugin-content-blog, docusaurus-theme-classic
    • #10768 feat(blog): Add author social icons for bluesky, mastodon, threads, twitch, youtube, instagram (@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
  • docusaurus-plugin-content-blog
  • docusaurus-module-type-aliases, docusaurus-plugin-svgr, docusaurus-preset-classic, docusaurus-types, docusaurus-utils, docusaurus

🐛 Bug Fix

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

📝 Documentation

🤖 Dependencies

🔧 Maintenance

  • Other
  • docusaurus-theme-search-algolia
  • docusaurus
    • #10798 refactor(core): Use Intl native API to get locale direction, remove rtl-detect depend… (@slorber)
    • #10747 refactor(core): swizzle wrap should use ReactNode instead of JSX.Element (@slorber)
  • create-docusaurus, docusaurus-mdx-loader, docusaurus-module-type-aliases, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-plugin-debug, docusaurus-plugin-ideal-image, docusaurus-plugin-pwa, docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-live-codeblock, docusaurus-theme-mermaid, docusaurus-theme-search-algolia, docusaurus-types, docusaurus
  • docusaurus-theme-common
    • #10728 refactor(theme-common): change storageUtils useSyncExternalCode getSnapshot workaround (@slorber)

Committers: 14

3.6.3

22 Nov 16:05

Choose a tag to compare

3.6.3 (2024-11-22)

🐛 Bug Fix

  • docusaurus

3.6.2

19 Nov 17:36

Choose a tag to compare

3.6.2 (2024-11-19)

🐛 Bug Fix

  • docusaurus-module-type-aliases
    • #10693 fix(types): add missing ambiant TS declarations for .md / .mdx partials (@slorber)
  • docusaurus-theme-translations
    • #10688 fix(theme-translation): add and update Japanese translations (@Ryoga-exe)
  • docusaurus
    • #10685 fix(cli): docusaurus --help should print plugin commands using extendCli() (@slorber)
  • docusaurus-bundler
    • #10680 fix(bundler): allow CSS nesting by default, restore postcss-preset-env (@slorber)
  • create-docusaurus
    • #10676 fix(create-docusaurus): add ts exclude to TS init template (@slorber)
  • docusaurus-bundler, docusaurus-faster, docusaurus
    • #10648 fix(faster): Upgrade to Rspack 1.1.1, fix build progress bar display (@slorber)

🔧 Maintenance

  • #10691 chore(ci): retry yarn install to ignore temporary network errors (@slorber)

Committers: 5

3.6.1

08 Nov 17:46

Choose a tag to compare

3.6.1 (2024-11-08)

🐛 Bug Fix

  • docusaurus
    • #10658 fix(core): bundler should not minimize static assets (@slorber)
  • docusaurus-bundler, docusaurus-faster, docusaurus-utils-common, docusaurus-utils
    • #10649 fix(faster,utils): fix faster/types peerDependencies (@slorber)

💅 Polish

  • docusaurus-bundler, docusaurus-types, docusaurus
    • #10655 refactor(faster,bundler,core): improve js loader DX (@slorber)

📝 Documentation

🔧 Maintenance

  • docusaurus-mdx-loader
    • #10651 refactor(mdx-loader): streamline typescript usage for remark plugin types (@lebalz)
  • Other

Committers: 2

3.6.0

04 Nov 10:58

Choose a tag to compare

3.6.0 (2024-11-04)

Blog post: https://docusaurus.io/blog/releases/3.6

🚀 New Feature

  • docusaurus-plugin-content-blog, docusaurus-theme-classic
    • #10586 feat(blog): Add frontMatter.title_meta to override title for SEO (@ilg-ul)
  • docusaurus
    • #10600 feat(cli): build/deploy should allow multiple --locale options (@slorber)
  • docusaurus-logger
  • docusaurus-plugin-rsdoctor
  • docusaurus-bundler, docusaurus-faster, docusaurus-theme-classic, docusaurus
    • #10402 feat(core): Replace Webpack with Rspack - siteConfig.future.experimental_faster.rspackBundler (@slorber)
  • docusaurus-bundler, docusaurus-faster, docusaurus-types, docusaurus
    • #10554 feat(core): faster HTML minimizer - siteConfig.future.experimental_faster.swcHtmlMinimizer (@slorber)
    • #10522 feat(core): faster CSS minimizer - siteConfig.future.experimental_faster.lightningCssMinimizer (@slorber)
  • docusaurus-theme-mermaid
    • #10510 feat(theme-mermaid): support Mermaid 11+ including new types of diagrams (@slorber)
  • docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages, docusaurus-types, docusaurus
    • #10479 feat(core, mdx-loader): deduplicate MDX compilation - siteConfig.future.experimental_faster.mdxCrossCompilerCache (@slorber)
  • docusaurus-faster, docusaurus-types, docusaurus
    • #10441 feat(core): faster JS minimizer - siteConfig.future.experimental_faster.swcJsMinimizer (@slorber)
  • docusaurus-faster, docusaurus-plugin-content-docs, docusaurus-types, docusaurus
    • #10435 feat(core): faster transpiler option - siteConfig.future.experimental_faster.swcJsLoader (@slorber)

🐛 Bug Fix

  • docusaurus-bundler, docusaurus
  • docusaurus-bundler
  • docusaurus-theme-classic
  • docusaurus-faster
  • docusaurus
    • #10611 fix(core): fix DOCUSAURUS_CURRENT_LOCALE = 'undefined' (@slorber)
    • #10423 fix(core): always use hash for CSS module class names (@slorber)
  • docusaurus-bundler, docusaurus-faster
  • docusaurus-theme-translations
  • docusaurus-mdx-loader
    • #10553 fix(mdx-loader): fix cross-compiler cache randomly loading mdx with client/server envs (@slorber)
  • docusaurus-tsconfig
    • #10547 fix(tsconfig): add @docusaurus/tsconfig target es2022 (@slorber)
  • docusaurus-plugin-content-blog
  • docusaurus-theme-classic, docusaurus-theme-common, docusaurus-theme-translations
  • docusaurus-types, docusaurus

🏃‍♀️ Performance

  • docusaurus-bundler, docusaurus-faster
  • Other
    • #10601 perf(ci): Add CI checks to prevent memory, build-time and build-size regressions (@slorber)
  • docusaurus
    • #10599 fix(core): fix i18n sites SSG memory leak - require.cache (@slorber)
  • docusaurus-mdx-loader, docusaurus-plugin-content-blog, docusaurus-plugin-content-docs, docusaurus-plugin-content-pages
    • #10470 refactor(mdx-loader): re-export metadata module instead of serializing it (@slorber)
    • #10457 refactor(mdx-loader): read metadata from memory (loaded content) instead of fs (@slorber)

📝 Documentation

🤖 Dependencies

Read more