11. Localize TinyMCE

Localize TinyMCE with global language capabilities.

Contribute to this page

As developers we all hope our projects reach a wide audience, and for many of us they do. This is why it is important that TinyMCE is easy to localize its language.

In this section of the Get Started guide we will show you how to change TinyMCE's user interface to suit your users' preferred language. The settings discussed in this section change the language that toolbar and menubar items, along with tooltips, are rendered in.

Pro tip: language settings can be controlled in these configuration options: directionality, language and language_url. There is also a Directionality Plugin that adds a toolbar button to control ltr-rtl behavior.

Step 1

Go to our language download page (i18n), where you'll see a list of language packs for TinyMCE 4.

If you want to use one language only, click the download link on the far right of the table. However, if you want to download multiple language packs, first check the box beside each language you need and then click the download button at the bottom of the table.

Important note: the language packs provided via our language download page are translated by the TinyMCE community. We greatly appreciate their contribution!

Step 2

Unpack the language js file(s) into your path/to/tinymce/langs/ folder. Important: if you don't put the language pack in langs/ the language settings will not work, unless you use the language_url configuration option.

Step 3

Set the language option in your TinyMCE configuration to the language code in the list on this page.

Step 4

Confirm that the language has been set successfully by loading TinyMCE.

A working example

We have prepared a code snippet below that would set TinyMCE's language to Chinese and text directionality right-to-left.

If you want to try it for yourself, download the Chinese language pack. You'll also need a local instance of TinyMCE, which you can grab from our downloads page. Follow the Self-hosted install instructions if you're not familiar with setting up TinyMCE locally.

<!DOCTYPE html>
<html>
<head>
  <script src="js/tinymce.min.js"></script>
  <script type="text/javascript">
  tinymce.init({
    selector: 'textarea',
    language: 'zh_CN',
    directionality: 'rtl'
  });
  </script>
</head>

<body>
  <form method="post">
    <textarea>你好,世界!</textarea>
  </form>
</body>
</html>

Can't find what you're looking for? Let us know.

Except as otherwise noted, the content of this page is licensed under the Creative Commons BY-NC-SA 3.0 License, and code samples are licensed under the Apache 2.0 License.