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.
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 what needs to be done 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.
Find the appropriate string container.
Modify the string to inform the user.
Save and apply changes.
Validate the modified message works
Access Localization in the manner described above.
Using the dynamic search filter, type "The Claim My Account Operation failed".
![]() |
The dynamic search returns exactly one result. Click the red lettering to display the default value.
![]() |
Next, enter a custom description in the Custom Value text box.
Click Save and then Refresh Caches; after clicking Save, the Localization Tree will refresh and Refresh Caches will be in an orange box.
Once the caches are refreshed the orange box disappears.
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.