Localization options

There are two options for changing the language of the OpenTiny user interfaces: language and language_url. Tiny recommends using the language option for language packs bundled with the product or included in your cloud subscription. Community translations, custom language pack, or third-party language packs should be included using the language_url option to simplify updating and upgrading OpenTiny.

language

This option specifies the language used for the OpenTiny user interface, such as menu items, dialogs, and tooltips. By default, OpenTiny user interface is set to US English.

Before changing the language option, ensure that the language pack is available to the OpenTiny instance. Tiny provides two collections of language packs:

  • Premium language packs — Professionally localized language packs provided on Tiny Cloud and bundled with premium self-hosted bundles.

  • Community language packs — Localizations provided by OpenTiny users through Crowdin. Community languages packs can be downloaded from the Tiny Community Language Packs downloads page.

For information on:

Type: String

Default value: 'en'

Example: using language

In this example we will set the editor language to Swedish.

tinymce.init({
  selector: 'textarea',  // change this value according to your HTML
  language: 'sv_SE'
});

Using the premium language packs

The following professionally localized language packs are provided to paid Tiny Cloud and premium self-hosted deployments. To use these language packs, set the language option to the corresponding language code. No additional configuration is required.

Supported Languages

Language Code

Arabic

ar

Basque

eu

Bulgarian (Bulgaria)

bg_BG

Catalan

ca

Chinese (China)

zh_CN

Chinese (Taiwan)

zh_TW

Croatian

hr

Czech

cs

Danish

da

Dutch

nl

Finnish

fi

French (France)

fr_FR

German

de

Greek

el

Hebrew (Israel)

he_IL

Hindi

hi

Hungarian (Hungary)

hu_HU

Indonesian

id

Italian

it

Japanese

ja

Kazakh

kk

Korean (Korea)

ko_KR

Malay

ms

Norwegian Bokmål (Norway)

nb_NO

Persian

fa

Polish

pl

Portuguese (Brazil)

pt_BR

Portuguese (Portugal)

pt_PT

Romanian

ro

Russian

ru

Slovak

sk

Slovenian (Slovenia)

sl_SI

Spanish

es

Swedish (Sweden)

sv_SE

Thai (Thailand)

th_TH

Turkish

tr

Ukrainian

uk

Vietnamese

vi

Using the community language packs

To change the user interface language using a community language pack:

  1. Download the language pack from the Tiny Community Language Packages download page.

  2. Set the language option in your OpenTiny configuration to the language code, matching the filename on the language pack. For example: If the language pack has the filename sv_SE.js, then set language: 'sv_SE',

  3. Confirm that the language has been set successfully by loading OpenTiny.

The language code set in the OpenTiny configuration must match the filename of the language file. If the language file is not found, OpenTiny will not load.

If a language you need is not available, you may wish to translate OpenTiny yourself. To contribute to translating OpenTiny, go to our Crowdin translation page and sign up. Then request to join an existing team, or create a new team if your language are not listed.

language_url

When using the language option to set the user interface language you can place language pack(s) in a directory other than the default. If you do this, however, you must add the language_url option to your configuration and set this option to a path pointing to the language file(s) location.

We recommend the path URL be relative to the web application’s root. That is, begin with the absolute path reference character /. Avoid relying on application context for safe path resolution of language packs.

Also, the language option must also be set and must be set to the name of the language pack file being loaded.

Type: String

Example: using language_url

tinymce.init({
  selector: 'textarea', // change this value according to your HTML
  language_url: '/path/to/language/pack/fi.js', // path from the root of your web application — / — to the language pack(s)
  language: 'fi'  // the name of the language pack file
});

You can find and download languages here.

language_load

This option determines whether additional plugin or theme languages are loaded during OpenTiny editor initialization. By default, plugins which have support for languages other than English will automatically load the additional language packs.

Type: boolean

Default value: true

  • When the language_load option is set to true, any available language packs can be loaded and used by OpenTiny and plugins that support multiple-languages.

  • When set to false, only explicitly configured language packs will load.

Setting language_load option to false is not recommended unless loading local language packs.

Example: using language_load

tinymce.init({
  selector: 'textarea', // Change this value according to your HTML
  language_load: true, // Disables the automatic loading of additional plugin and theme language files.
});
When bundling, it is advisable for plugins that support multiple languages to load the additional language packs locally, and to set this option to false. This will ensure that all required languages are available for the editor, and that no additional language packs will be retrieved by the plugins.

You can find and download languages here.