Localization
Localization provides users with the RapidIdentity System Admin role the ability to configure text within RapidIdentity.
Localization modules are grouped into component containers to help facilitate navigation and understanding of where a localization string is found within the product.
There are two major functionalities in this module:
Create custom labels or other text.
Create new translations for non-English speaking audiences.
![]() |
Creating Custom Labels and Text
The most common localization use case is to make a particular message more friendly or informative by adjusting a single word or the overall phrasing.
The most efficient method to solve this use case is to locate the proper container to modify the string in question by using the dynamic search filter. For example, to find all containers regarding labels, search for "label" in the bar and hit Enter.
![]() |
Sample Use Case: Claim My Account
Consider the following error message in response to a failed attempt to Claim My Account attempt.
![]() |
In this example, the red error message states that the Claim My Account operation failed. However, it does not provide the user any additional information to clarify what step(s) should be taken to execute the Claim My Account operation properly.
While there are many different reasons that could uniquely or collectively trigger this error message, from the localization perspective, the best option here is to modify the error message to inform the user what they should do before panicking and contacting their Support team.
The overall problem-solving approach includes the following steps.
Access RapidIdentity Appliance Localization.
Modify the string to inform the user.
Save and apply changes.
Validate the modified message works
Access Localization from Configuration > General > Localization
.
Using the dynamic search filter, type "Claim My Account operation failed". The dynamic search returns one result. Click the Edit button on the right to display the default value and open a field for a new, custom value.
![]() |
Next, enter a custom description in the Custom Value text box.
Click Save and then Refresh Cache. The localization tree will refresh.
Finally, validate the overall process by attempting to fail the Claim My Account operation.
![]() |
If the refreshed custom value is not desired or needs to be replaced, either edit the custom value as desired or click the Revert to Default button. Then click the Refresh Caches button to apply the changes.
Creating a New Locale
Creating a new locale involves cloning an existing locale. Thus, all new locales require manual translation to the desired language in the new locale.
To create a new localization, do the following.
Access RapidIdentity Appliance Localization and then click Clone Locale.
![]() |
Name the new locale, then click Clone.
![]() |
The new locale can now accept updates or translations to new languages.
![]() |
Delete an Existing Locale
To delete a locale, click Delete Locale, select the desired locale, and then click Delete.
![]() |
![]() |
Click Refresh Cache to update the selected locale.