Localize TinyMCE

Localize TinyMCE with global language capabilities.

Contribute to this page

TinyMCE makes your project accessible to the world through its simple localization framework.

This section demonstrates how to change TinyMCE’s user interface to the user’s language preference. These settings change the language in the toolbar, menu items, buttons, and tooltips.

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 the language download page to review a list of language packs available for TinyMCE.

Click the download link on the far right of the table for a single language. Check the box beside each language and then click the download button at the bottom of the table for multiple languages.

Important: The TinyMCE community translation project provides the language packs on our language download page.

Step 2

Unpack the language js file(s) into the path/to/tinymce/langs/ folder.

Important: The language settings will not work unless the language pack is placed in langs/ directory. The language_url configuration option is another method to enable additional language settings.

Step 3

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

Step 4

Load TinyMCE to confirm that the language is set correctly.

A working example

The following code snippet sets TinyMCE’s language to Chinese and the text directionality from right to left.

Download the Chinese language pack to test this functionality. Install a local instance of TinyMCE from the downloads page. Follow the Self-hosted install instructions.

<!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.