Contribute to this guideReport an issue

Setting Editor User Interface Language

CKEditor 4 is translated into 70 languages and by default, it is displayed in the user’s language (as set in the browser or operating system settings). If the matching language version is not available, the editor user interface will be displayed in the default language version (most commonly: English).

Please note that CKEditor 4 localizations are mostly provided by our awesome community through the CKEditor UI Translation Center, so if you would like to help with translating CKEditor 4 into your native language or correct an existing localization, do not hesitate to join us!

# Setting the Default Language

The website developer can set the default language that will be used for the CKEditor UI if the user’s language is not available. English is the default setting here, but you can adjust this to your needs by modifying the CKEDITOR.config.defaultLanguage configuration option.

For example, if your website is targeted at the German audience, you may want to set the default CKEditor UI language to German, too:

config.defaultLanguage = 'de';

This will cause CKEditor 4 to be displayed in German to all users for whom a matching localization cannot be found.

CKEditor 4 WYSIWYG editor with the UI language set to German.

# Overriding User Language Settings

The developer is also able to force CKEditor 4 to always use just one pre-defined UI localization. This will mean that no matter what locale settings the user browsers and operating systems use, CKEditor 4 will always be displayed in the language set by the developer.

This feature may come in handy for all homogeneous environments where the entire user base speaks the same language. The developer will then be able to create a custom build stripped of all redundant language files except for the desired localization.

If you want to define the language that will override all user settings, use the CKEDITOR.config.language configuration setting.

For example, if your website is in German and you want to display the German language version of the CKEditor UI to all your visitors (no matter what their locale settings are), use the following setting:

config.language = 'de';

This will cause CKEditor 4 interface to be displayed in German to all users, overriding their browser-stored preferences.

# UI Languages Demo

See also the working “Setting Editor UI Language” sample that showcases all available CKEditor user interface localizations and includes a simple script that lets the user choose a different language version.