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: