Localize Text in EmpowerID

A Locale Key represents each text string in the EmpowerID web UI. Developers use locale keys for elements like titles, descriptions, and labels across the user interface (UI). The Localized Text page in EmpowerID allows administrators to customize the default text and add translations for any languages your organization supports.

This article walks you through how to:

1. Customize Default Strings

2. Localize Strings by adding translations for other supported languages.

Customizing Default strings

Customizing default strings in EmpowerID allows you to adjust terminology to suit your organization's needs better. In this example, we’ll change the term "recertification" to "attestation" to avoid confusion in an industry where "recertification" has specific connotations.

Follow these steps to customize a default setting:

1. Access the Localized Text Page:

   • On the navbar, expand Admin > Miscellaneous and select Localized Text.

2. Search for the String to Customize:

   • Select the Localized Strings tab and use the search bar to find the term you want to modify. For this example, search for recertification.

3. Edit the Locale Key Entry:

   1. Click the Key Entry Name link for the one you want to customize, for example, RecertificationRevokesAllDescription.
      
      

      Open

      

       

   2. On the View page for the Locale Key that appears, click the Edit button.
      
      

      Open

      

       

4. Update the Default Value:

   • In the Default Value field, replace “recertification” with “attestation” and save your changes.

Localizing Strings for Specific Languages

Localization involves adding translated values for specific locales so that users can view the interface in their preferred language.

To localize a string, follow these steps:

1. Search for the String to Localize:

   1. From the Find Locale Key Entry page, select the Localized Strings tab.

   2. Search for the string you want to localize.

2. Open the Locale Key for Editing:

   1. Click the Locale Key (Unique Name) link to open the View page for the string.

   2. On the View page, click the Edit link to put the string in Edit mode.
      
      

       

3. Add or Update a Translation:

   1. Select the Translations tab.

   2. To edit an existing translation, click the Edit button for the desired language, update the value, and save your changes.

   3. To add a new translation, click the Add New button, select the language, enter the translation, and save.
      
      

       

Best Practices for Localizing Text

• Consistent Terminology: Ensure that translated terms are consistent with industry-specific language used by your organization.

• Fallback Default: Always provide a default value for each locale key to ensure a fallback option when translations are missing.

• Testing Translations: After adding or editing translations, verify changes by setting a user profile to the specific locale and viewing the updated text in the web UI.