10. Localize TinyMCE

Localize TinyMCE with global language capabilities.

Contribute to this page

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

In this section, we 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: The TinyMCE community translates the language packs provided on our language download page. We much 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.