---
title: "Internationalization"
description: "Topol provides 21 languages that are premade, tested and regularly updated. All these languages are built-in."
url: https://docs.topol.io/email-editor/guide/i18n.html
---

# Internationalization

**The editor interface ships translated into 21 languages.** One option picks the language, and individual strings can be replaced where your product uses different terminology.

## Define the language

When initializing the Topol Plugin, add the `language` code in the `TOPOL_OPTIONS` configuration object.

```ts
const TOPOL_OPTIONS = {
  id: "#app",
  authorize: {
    apiKey: "YOUR_API_KEY",
    userId: "YOUR_USER_ID",
  },
  language: "fr", // Example: French
};
```

Languages use `ISO 639-1` standard.

> **WARNING**
>
> Only the two-letter codes below are recognized. Region variants such as `pt-BR` or `zh-CN` are not accepted, so `pt` covers both European and Brazilian Portuguese and `zh` is Simplified Chinese. An unrecognized code falls back to English one string at a time and logs warnings to the console, rather than failing outright.

## List of all currently supported languages

| Country | Language | Code |
| --- | --- | --- |
| ![United States Of America flag](https://image.ibb.co/noaoGp/153_united_states_of_america.png) ![United Kingdom flag](https://image.ibb.co/kG0Nbp/262_united_kingdom.png) | English | en  |
| ![France flag](https://image.ibb.co/gnK4p9/077_france.png) | French | fr  |
| ![Brazil flag](https://image.ibb.co/cPdm2U/250_brazil.png) ![Portugal flag](https://image.ibb.co/heBdGp/174_portugal.png) | Portuguese | pt  |
| ![Spain flag](https://image.ibb.co/fMm0U9/044_spain.png) | Spanish | es  |
| ![Japan flag](https://image.ibb.co/i7a5wp/033_japan.png) | Japanese | ja  |
| ![China flag](https://image.ibb.co/mQgjp9/261_china.png) | Chinese | zh  |
| ![Russia flag](https://image.ibb.co/cKqG2U/228_russia.png) | Russian | ru  |
| ![Turkey flag](https://image.ibb.co/iOom2U/119_turkey.png) | Turkish | tr  |
| ![Germany flag](https://image.ibb.co/gYXkwp/066_germany.png) | German | de  |
| ![Sweden flag](https://image.ibb.co/jUm62U/073_sweden.png) | Swedish | sv  |
| ![Netherlands flag](https://image.ibb.co/mUg0U9/195_netherlands.png) | Dutch | nl  |
| ![Italy flag](https://image.ibb.co/n6KLU9/011_italy.png) | Italian | it  |
| ![Finland flag](https://image.ibb.co/hcEyGp/052_finland.png) | Finnish | fi  |
| ![Romania flag](https://image.ibb.co/b4uyGp/050_romania.png) | Romanian | ro  |
| ![Czech Republic flag](https://image.ibb.co/hF7799/061_czech_republic.png) | Czech | cs  |
|     | Slovak | sk  |
| ![Poland flag](https://image.ibb.co/fNAoGp/108_poland.png) | Polish | pl  |
| ![South Korea flag](https://image.ibb.co/gXuXbp/055_south_korea.png) | Korean | ko  |
| ![Vietnam flag](https://image.ibb.co/ks05wp/164_vietnam.png) | Vietnamese | vi  |
| ![Israel flag](https://image.ibb.co/ds05wp/060_israel.png) | Hebrew | he  |
|     | Arabic | ar  |

Feel free to contact us if you need to add another language or find an incorrect translation.

## Changing the language after initialization

The language is not fixed at startup. Passing a new one to `updateOptions` reloads the interface strings in place:

```js
window.TopolPlugin.updateOptions({ language: "de" });
```

> **INFO**
>
> This changes the language of the editor interface. Translating the template's own content is a separate feature, covered in [Multilingual Templates](https://docs.topol.io/email-editor/guide/multilingual-templates.html).

## Right-to-left languages

Arabic and Hebrew are translated, and new text blocks in those languages are created with right-to-left content. **The editor interface itself stays left-to-right**, since panels and toolbars are not mirrored.

## Renaming individual labels

Single strings can be replaced without changing the language, which suits products whose own terminology differs from the editor's. The `textOverride` option covers this and is documented in [Custom UI Labels](https://docs.topol.io/email-editor/guide/custom-labels.html). Overrides apply to whichever language is active, so a plugin offering several languages needs a set per language.

* * *

Flags made by [Freepik](http://www.freepik.com) from [www.flaticon.com](http://www.flaticon.com)