PingOne

Using translatable keys

You can add translatable keys for any user-facing text in your forms, including the input field labels, button labels, and rich text. After adding these keys, the text can be translated based on the user’s browser settings for preferred languages.

About this task

To add a translatable key:

Steps

  1. In the Edit Form section of a form, click on a section of your form that includes text to localize.

    Result:

    A side panel with the element’s configuration settings opens.

  2. Click the Translation (An image of the universal translation icon.) icon.

    Result:

    A modal with a list of the available keys and their default translations opens.

  3. Select the appropriate Key.

    If you’re adding translatable keys for a button, the appropriate Key is Button.text, where Submit is the default translation.

  4. Optional: To define a unique key and default translation, select Create New Key.

  5. Click Select.

    Result:

    A key is added to the field with the Translation (An image of the universal translation icon.) icon.

  6. Optional: Click the key and enter a custom default translation in the Enter Default Translation field. Click Save.

Next steps

Repeat the steps for elements in the form with user-facing text. After you have added translatable keys, you must configure which languages are enabled for translation in the User Experience > Languages section. For more information, see Enabling or disabling a language.