Skip to main content

Internationalization and versioning

Docusaurus makes it easy to create documentation tailored to a global audience and to manage different versions of your product or service.

Internationalization (i18n)​

If your documentation should be available to users worldwide, multilingual support is an important feature. With Docusaurus, you can easily manage multiple languages in the same project, thanks to built-in internationalization support.

How it works​

Docusaurus organizes content for each language in separate directories. When you build your site, a language switcher is created so users can navigate between language versions.

Example structure:

i18n/
├── sv/
│   ├── docusaurus-plugin-content-docs/
│   │   ├── current/
│   │   │   ├── intro.md
│   ├── docusaurus-theme-classic/
│   │   ├── navbar.json
│   ├── docusaurus-plugin-content-blog/
│   │   ├── 2025-01-01-welcome.md
├── en/

Example URL structure:

  • Swedish: example.com/docs/intro
  • English: example.com/en/docs/intro
  • French: example.com/fr/docs/intro

Benefits of multilingual content​

  • Global accessibility – Make it easy for users from different regions to understand your documentation.
  • Centralized management – All content stays organized within the same project.
  • Automatic language switcher – Docusaurus adds a language dropdown in the navigation.

Versioning​

Docusaurus also offers powerful versioning, making it possible to maintain documentation for multiple versions of your product.

How it works​

Versioning lets you copy an existing set of documentation and archive it as a specific version. At the same time, you can keep updating the latest version.

Example:

docs/
├── versioned_docs/
│   ├── version-1.0/
│   │   ├── intro.md
│   ├── version-2.0/
│   │   ├── intro.md
├── current/
│   ├── intro.md

Example URL structure:

  • Version 1.0: example.com/docs/v1.0/intro
  • Version 2.0: example.com/docs/v2.0/intro
  • Latest version: example.com/docs/intro

Benefits of versioning​

  • Clarity for users: Users can easily navigate to the documentation version that applies to their product.
  • Efficient management: Keep older versions as reference while updating the latest one.
  • Flexibility: Customize content for specific versions without affecting others.

Combine internationalization and versioning​

These two features work seamlessly together. For example, you can have multiple language versions of the same documentation for different product versions.

Examples:

  • Swedish, version 1.0: example.com/docs/v1.0/intro
  • English, version 1.0: example.com/en/docs/v1.0/intro
  • English, latest version: example.com/docs/intro

✨ Next step – Learn how you can optimize the user experience with a powerful search function! ✨