Localization for KMS/KAF Administrators - How to Change Your Kaltura Application Language?

To help ensure a quality user experience, Kaltura MediaSpace and KAF applications provide localization configuration to adapt online content for regional specificity. Using the Application and Languages modules in the Kaltura MediaSpace Admin Console and the Languages module in the KAF Admin Console, the KMS/KAF admin can control the MediaSpace/KAF instance localization features.

Customizing Languages for a KMS

 To configure the KMS language

  1. Login to MediaSpace Admin Console
  2. Select the Application module in the Global section.
  3. Set the following:

    • languageConfiguration – Set the instance configuration: multi-language instance or single language instance.
    • languageSelection - Choose the default language for a new user in this specific instance.

  4. When the instance is configured to Multi-language, select the languages available from the languageSelection field.

The available languages in the languageSelection field are built from the out-of-the-box Kaltura languages in addition to custom languages that were created by the admin previously.

Customizing Languages for a KMS or KAF Instance

Use the Languages module in the KMS Management Console or the KAF Admin Console to create a custom language or change text in an available language. 

For KAF: Follow the KAF Specific Instructions in addition to the customizing instructions that follow.

You will need to download the existing application text file and then upload the new/modified file.

To download language texts

  1. Select the Languages module in the Global section.
  2. In the DownloadLocaleText field,click Download Texts to download the latest texts of KMS. 

    A zip file with a standard locale.po files for all languages are created. The zip file contains all text for all languages for this specific KMS/KAF instance.

  3. Select the desired language and modify the text as necessary. You can use translation editors available on the web,  for example, poedit, to modify text. The final result should be a binary .mo file.

To upload language texts

  1. Select the Languages module in the Global section.
  2. Click +Add Upload Custom Language to upload the new/modified texts for KMS or your KAF instance (a binary .mo file).
  3. Configure the following fields to upload the custom Language and click Save.




    Enter the name of the language to be presented in the language drop-down list (for the admin), in Application module, languageSelection, and language fields.


    Enter the name of the language to be presented in the language drop-down list for the users.


    For KAF only: Select the formal language code to be used to sync the instance language to the hosting application (LMS,CMS, SBS) chosen language.


    Click upload locale. Upload your customized .mo file. In order to convert your customized .po file to an.mp file, you can use some available tools on the web.


    Click upload flag. Upload a custom language flag icon to be presented to the users. The icon should be in *.jpg;*.jpeg;*.bmp;*.png;*.gif;*.tif;*.tiff;*.ico format and the dimensions should be 30px X 26px (The application will resize any given image, however for the best visual result, use these dimensions). You can also choose from this library of icons: http://freebiesbug.com/psd-freebies/100-flat-flag-psd-icons/


    Unique language id for application usage (not for KMS/KAF admin usage).

KAF Specific Information

When the instance is from a KAF-based LMS Extension (specifically - Sakai, Blackboard, Canvas, Brightspace, Moodle to follow in the future) the following is relevant:

  • The Kaltura instance (the Kaltura screens) receives the language settings from the hosting application (Sakai, Blackboard, Canvas, Brightspace) – whether created or added by the application admin or the user.
  • Custom languages may be added as described in the Customizing Languages for a KMS or KAF Instance section in this article.

  • The languageCode field is for KAF use only. The KAF admin should set it for a custom language. This field is used to sync the instance language to the hosting application chosen language. The languageCode of a custom language takes precedence over the Kaltura default language with the same code.

Language Exceptions

"Language Exception" fields were added to the Languages module and support multiple language exceptions for both the Kaltura MediaSpace and KAF applications.  Admins can change a specific language text/string to any other supported language, without having to upload a new MO file. The text/string change is made directly in the admin Languages module.

To add a language exception and change any string in the app

It is recommended to download the English PO to retrieve all the relevant text in the form of 'msgid. 

  1. Choose the language you would like to apply the exception to.
  2. Enter the text you want to change in English. Copy the exact msgid text from the PO file.
  3. Enter the new text in your selected language.


  1. The list of languages displayed is from the available POs.
  2. Note if a PO is removed, the exception may remain however the application will not render the changed text string.

For a language exception example, please refer to How to change the Access Denied error message?.

In This Article
Was this article helpful?
Thank you for your feedback!