How To Add Language Support | Official Documentation

Add support for additional languages to extend platform accessibility and usability across global teams.

How to Add Language Support

🌍 Language Support

OpenMetadata offers multi-language support to provide a more accessible and localized experience for global teams. Users can change the application language from the top-right corner of the UI by selecting from a list of supported languages.

✅ Currently Supported Languages

The following languages are available out of the box:

• English (EN)
• Korean (KO)
• French (FR)
• Simplified Chinese (ZH-CN)
• Traditional Chinese (ZH-TW)
• Japanese (JA)
• Portuguese (Brazil) – PT-BR
• Portuguese (Portugal) – PT-PT
• Spanish (ES)
• Galician (GL)
• Russian (RU)
• German (DE)
• Hebrew (HE)
• Dutch (NL)
• Persian (PR)
• Thai (TH)
• Marathi (MR)
• Turkish (TR)

📁 Adding or Customizing Language Support

If you’d like to:

• Contribute a new language,
• Customize existing translations,
• Or enable internal company-specific terms,

You can do so by editing or adding JSON files in the locale/languages directory of the OpenMetadata frontend codebase.

Each language is structured like this:

// Example: fr-fr.json
{
  "home.welcome": "Bienvenue",
  "table.title": "Tables",
  ...
}

To add support for a new language in our internationalization setup using react-i18next and i18next, please follow the steps below:

Create a Language JSON File

First, create a new JSON file for the language you want to add in the openmetadata-ui/src/main/resources/ui/src/locale/languages directory.

For example, if you want to add support for the French language, you can create a file called fr-fr.json in the languages directory:

# Navigate to the ui/src/locale/languages directory
cd openmetadata-ui/src/main/resources/ui/src/locale/languages

# Create the French language file
touch fr-fr.json

Sync the Language File with the Primary Language

To ensure consistency with our primary language, which is en-us, it is necessary to synchronize any newly added language files. This can be done by copying the content from the en-us.json file and translating it accordingly.

To copy the contents of en-us.json and add it to your translation JSON file, follow these steps:

• Go to en-us.json
• Copy the content of file
• Open your translation JSON file.
• Paste the copied text into your translation JSON file.

You can refer to the image below for a visual guide:

How to Add Language Support for Entities Documentation

We have documentation for some entities on the left sidebar, and we currently support two languages: en-US and fr-FR. If you want to add support for other languages in our internationalization, you can follow the steps below.

Documentation for entities resides in the openmetadata-ui/src/main/resources/ui/src/public/locales directory. Our primary language is en-US, so you can refer to it and create the same hierarchy for your language.

To add documentation in the zh-CN language, you can simply copy the en-US directory and rename it to zh-CN. Then, update the content of the files according to the zh-CN language.

To find the supported language codes, you can refer to this page.