View Categories

How to Customize Application’s Interface Text

This article will explain how to customize the application interface text according to your needs – change labels’ names, create new hints, and modify notifications’ content.

Accessing the language bundles page #

To access the Language bundles page, hover over the Settings tab in the main menu and select the System and customization option.

 

Then, click the Theme and language tab and the Language bundles tab.

Preview keys mode #

To easily find the desired property value, you can use the preview keys mode by clicking on Activate preview keys mode button at the top of the language bundle table.

After the mode is activated, select the key icon at the top of the page in order to see the desired property value.

To turn off the preview keys mode, click the key icon again, and select the Deactivate preview keys mode button.

Customizing the application’s interface text #

There are 6 default language bundles in the system. A language bundle is a file consisting of the key/value pair properties. Each property is tied to one or many UI components based on a property key.

 

 

It is impossible to delete default language bundles, but you can create new ones based on them. Also, it is not possible to have two active bundles of the same type simultaneously.

There are two ways to create a custom language bundle:

  1. Changing the language bundle by editing one-by-one property values.
  2. Downloading the language bundle, editing the file offline using the desired text editor, and importing it into the application.

Note: The keys must not be changed. Otherwise, the changes will not be visible.

To create a new language bundle by editing one-by-one property values:

  1. Select the Actions option and the Edit option for the language bundle based on which you want to create a new one.
  2. Search for the property value or key you want to change.
  3. Choose the desired key from the list. If you cannot find the key for the desired property value, you can use the preview key mode to find it easily.
  4. Edit the text.
  5. Confirm or discard the changes you made in the property value field.
    Note: You can edit as many property values as you want in one language bundle. All of them will be displayed when you activate the language bundle.
  6. Click the Save as button to save a new language bundle.

To create a new language bundle by uploading a file:

  1. Download the language bundle and edit the file by changing the property values.
    Note: The downloaded file will be saved in .properties format.
  2. Load the file by clicking the Load from properties file button. The Choose file dialog will appear. Choose a modified .properties file and confirm your choice.
  3. Click the Save as button to create a new language bundle.

Once you create a new language bundle, it will have an inactive status.

To activate a new language bundle:

  1. Click the Activate button.
  2. Click the Yes button in the pop-up window.

Note: Once you activate the language bundle, it will be applied globally, and the currently active bundle of the same type will be deactivated.

Example of how the message looks before and after changes.

Before

After

You can reactivate the default language bundle at any time. If you want to delete a custom language bundle:

  1. Click the Trash can icon.
  2. Click the Yes button in the pop-up window.

After deleting an active custom language bundle, the default bundle will be activated automatically.

Powered by BetterDocs