Skip to main content
All CollectionsBusiness Admin
Localization in Business Admin
Localization in Business Admin

Customize the interface language of eWizard services in the Localization section with the language-specific JSON file

eWizard Team avatar
Written by eWizard Team
Updated over 3 months ago

Localization within the INTERFACE section is a part of eWizard Business Admin where you can change the interface language of certain eWizard services in two ways: with the localization file or through the auto translation. As a result, a new LANGUAGE option becomes available for selection on the account settings page for all users within the given eWizard environment.

You can download a localization file and translate interface strings in any source code editor or localize the file externally.

Localization window

In the main area of the INTERFACE LANGUAGES page, you can do the following:

  • Add a new language with the button.

  • Edit the ISO codes of an existing language with the button.

  • Delete an existing language with the button.

Add languages

To create a custom interface language:

  1. Click the button in the main area of the INTERFACE LANGUAGES page.

  2. In the Create interface language pop-up, fill in the following metadata fields:

    • NAME—the language name displayed in the user profile.

    • ISO1 and ISO3—the international language codes.

    Create interface language popup

The fields marked with asterisks (*) are mandatory.

3. Click SAVE.

The new language is added to the list of interface languages available for localization.

Manage localization files

After creating a new language, you can manage its localization files in the following way:

  1. Click the required language in the NAME column.

    Localization main screen

2. On the language details page, download the localization JSON file to your device with the DOWNLOAD button.

When editing system attributes or using restricted symbols in the localization file, errors may occur. Please read the editing guidelines before making any changes in the localization JSON file.

Download localization file

3. Localize the file. You can make the changes yourself, or send the file to a translation agency.

To localize the interface strings with the Viseven translation agency, contact your liaison manager.

4. Once the localization is complete, click UPLOAD to add the JSON file to the system.

Upload localization file

On the language details page, you can also edit or delete the existing interface language.

Editing guidelines

To localize the eWizard interface to different languages, you can edit the common and services sections of the downloaded JSON file. The default language in the localization file is English.

Edit the localization file in any source code editor, and save the result in the JSON format.

Localization file example
  • In the common section, you can localize interface strings common for all eWizard services covered by localization.

  • In the services section, you can localize interface strings specific to separate eWizard services.

To prevent errors, don't edit the values of the __mapping__ section, which contains system data.

For example, translate the add_new field from Add new to Tilføj ny in the Danish localization file.

Add new field in Danish

After uploading the file, the ADD NEW button in Library is displayed as TILFØJ NY.

Library in Danish

You can use HTML text formatting tags for pop-up and error message texts.

Restrictions

❌ Don't add objects to the localization file. eWizard doesn't recognize them.

❌ Don't edit the existing object names in the localization file. For example, edit only the Advanced filters value in the advanced_filters object.

Editing example

❌ Don't add or remove the   and {} symbols in the text values.

Auto translate

Business Admin offers automatic translation of the interface strings to multiple languages and view the customized interface on the fly.

To initiate auto translation:

  1. Click the existing language name NAME on the INTERFACE LANGUAGES page or add a new language and then select it.

  2. Click the AUTO TRANSLATE button.

Once the auto translation is complete, the system notifies you about it. Then, you can proceed to customizing the eWizard interface language.

Please note that automatic translation is machine-generated and may require human validation for accuracy.

To make changes in the resulting file:

  1. DOWNLOAD the localized JSON file from the language details page.

  2. Correct the localized interface strings where needed.

  3. UPLOAD the updated JSON file back to the system.

  4. Repeat the interface customization steps.

Customize interface

To apply the customized interface language, any user of the given eWizard environment can go to their profile and change the current language to the required one. For example, the Library interface localized in Danish:

Library in Danish

If you enter the correct ISO 639-1 or ISO 639-3 code for the language, the calendar is also adjusted to the appropriate region.

Localized calendar example

Did this answer your question?