Skip to content

docusaurus build has no way to keep path-based locale switching in a single-locale build #12586

Open

Description

@ctreatma

Have you read the Contributing Guidelines on issues?

Prerequisites

  • I'm using the latest version of Docusaurus.
  • I have tried the npm run clear or yarn clear command.
  • I have tried rm -rf node_modules yarn.lock package-lock.json and re-installing packages.
  • I have tried creating a repro with https://new.docusaurus.io.
  • I have read the console error message carefully (if applicable).

Description

The docusaurus build command automatically disables path-based locale switching for single-locale builds. Per code comments, this decision was made to more easily support domain-based locale switching. However, the CLI offers no way to override this behavior and keep path-based locale switching for single-locale builds, which means Docusaurus users cannot build locales in parallel if they want to keep path-based locale switching.

Reproducible demo

No response

Steps to reproduce

  1. Create a Docusaurus site with multiple locales
  2. Build the locales in parallel and then merge the builds

Expected behavior

It should be possible to build locales for a Docusaurus site in parallel and then merge them. The CLI should offer a way to turn off

Actual behavior

The CLI builds each locale to the root path, so builds cannot be easily merged, and the locale dropdown does not work correctly (selecting a different locale reloads the default locale page instead of switching to the selected locale).

Your environment

  • Public source code:
  • Public site URL:
  • Docusaurus version used:
  • Environment name and version (e.g. Chrome 89, Node.js 16.4):
  • Operating system and version (e.g. Ubuntu 20.04.2 LTS):

Self-service

  • I'd be willing to fix this bug myself.

Activity

  1. added
    bugAn error in the Docusaurus core causing instability or issues with its execution
    status: needs triageThis issue has not been triaged by maintainers
    on Oct 7, 2026
  2. 0xd34db8 commented on Oct 7, 2026

    @0xd34db8

    I am working on this.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugAn error in the Docusaurus core causing instability or issues with its executionstatus: needs triageThis issue has not been triaged by maintainers

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions