Providing your own localization

Knowledge Base
1

Cumulocity’s administration app offers the option to provide your own translations for certain texts. The process for doing so is described in the documentation.

This user interface only allows to add further translations for already supported languages. At the time of writing this, the supported languages are: German, English, English (US), Spanish, French, Japanese, Korean, Dutch, Polish, Portuguese, Chinese and Chinese (Taiwan)

In case you would like to add support for a whole new language, you can also do so by utilizing the Advanced branding tab of the Branding feature.

By adding the follwoing attribute to your JSON structure:

  "languages": {
    "de_CH": {
      "name": "German (CH)",
      "nativeName": "Deutsch (Schweiz)"
    }
  }

You could add for example swiss german to the supported languages.

image
image1306×730 70.1 KB

After saving this change and applying this branding globally, you should be able to find the newly added language in the language settings and also in the localization user interface.

From there you can then go ahead and translate existing texts into your newly added language.

4 Likes
2

What are the requirements for the name of a new language?

We tried with “rg” and while this shows up in the localization dialog and as a language to select, translation actually fails with an error in the console about not being able to find “./rg.json” despite the translation.zip containing the file. If we use “en_RG” instead it works.

3

ok, confirmed internally. This does not support completely new languages.