--- title: Localizing flows with PingOne description: Localizing a flow lets you present a single flow to customers who use multiple languages, providing a better experience for customers and reducing backend complexity. component: davinci page_id: davinci:use_cases:davinci_use_cases_localizing_flows canonical_url: http://docs.pingidentity.com/davinci/use_cases/davinci_use_cases_localizing_flows.html revdate: September 22, 2023 section_ids: procedure: Procedure creating-forms: Creating forms about-this-task: About this task steps: Steps adding-languages-and-translations: Adding languages and translations about-this-task-2: About this task steps-2: Steps adding-forms-to-flows: Adding forms to flows about-this-task-3: About this task steps-3: Steps result: Result --- # Localizing flows with PingOne Localizing a flow lets you present a single flow to customers who use multiple languages, providing a better experience for customers and reducing backend complexity. You can use the PingOne **Languages** feature to provide translations for forms created in PingOne. In this solution, you create one or more forms in PingOne and then use the **Languages** feature to add translations for the fields, options, error messages, and other content used by those forms. You then include the forms in your DaVinci flows. When a user reaches one of the forms, PingOne uses their browser's language setting to present them with the correct translation of the form. ## Procedure This section shows you how to create one or more forms, add translations for those forms, and add the forms to one or more flows. | | | | - | -------------------------------------------------------------------------------------------------------------------------------------------------- | | | The forms, languages, and flows in your environment will vary. This procedure is as specific as possible while still applying to all environments. | ### Creating forms #### About this task First, create one or more forms in PingOne. | | | | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | This procedure does not cover all of the options available in the **Forms** section. You can find information about all available options in the [Forms documentation](http://docs.pingidentity.com/pingone/user_experience/p1_forms.html). | #### Steps 1. Sign on to PingOne and go to **User Experience > Forms**. 2. Click the **[icon: plus, set=fa]**icon to create a new form. 3. In the **Form Name** field, enter `User Information Example`. 4. In the **Form Usage** list, select **DaVinci Flow Forms**. 5. Click **Add Form**. 6. Select a template or a blank form as a starting point. 7. (Optional) Add one or more custom fields and create a translation key for each one: 1. Drag the custom field onto the form. 2. In the left pane, click the translation key icon in the **Label** field. ![This screenshot shows the Label field with the translation key icon highlighted.](_images/kel1685120582765.png) 3. Select **Create New Key**. 4. In the **Key** column, enter an internal name for the key. 5. In the **Default Translation** column, enter the value of the key in your environment's default language. 6. Click **Select**. 8. (Optional) Drag one or more **PingOne Attribute Fields** onto the form. 9. Click **Save**. ### Adding languages and translations #### About this task After creating your forms, enable one or more languages, then provide translations for the fields in your forms for each enabled language. | | | | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | | This procedure does not discuss all options available in the **Languages** section. For more information about all available options, see the [Languages documentation](http://docs.pingidentity.com/pingone/user_experience/p1_languages.html). | #### Steps 1. Sign on to PingOne and go to **User Experience > Languages**. 2. Click the **[icon: plus, set=fa]**icon to add a language. 3. In the **Languages** list, select a language to add. 4. Click **Save Changes**. 5. Select the language that you added from the list of languages. 6. In the **Module** list, select **DaVinci Forms**. 7. Provide translations for the standard fields in your forms: 1. In the **Page** list, select **Standard Fields**. 2. Click the **Pencil** icon. 3. Enter translations for the standard fields that you used in your forms. 4. Click **Save**. 8. Provide translations for the custom fields in your forms: 1. In the **Page** list, select **Custom Messages**. 2. Click the **Pencil** icon. 3. Enter translations for the custom fields that you used in your forms. 4. Click **Save**. 9. Provide translations for additional text that you used in your forms: 1. In the **Page** list, select **Others**. 2. Click the **Pencil** icon. 3. Enter translations for the additional text that you used in your forms. 4. Click **Save**. 10. (Optional) Repeat steps 5-9 for each additional language that you have enabled. ### Adding forms to flows #### About this task After adding your languages and translations for your forms, add the forms to your flow. | | | | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | This procedure does not discuss all of the options available for the Form connector. For more information about all available options, see the [Form connector documentation](http://docs.pingidentity.com/connectors/form_connector.html). | #### Steps 1. Sign on to DaVinci and click the **Flows** tab. 2. Find the flow to which you want to add the forms and go to **... > Edit**. 3. Click the **[icon: plus, set=fa]**icon to add a node. 4. In the **Add Connector** list, select the **PingOne Forms** connector. 5. Click and drag a line from the new node to the existing nodes. 6. Click the **PingOne Forms** node. 7. Select the **Show Form** capability. 8. In the **Form** list, select your form. 9. Click **Apply**. 10. (Optional) Repeat steps 3-9 for each additional form that you want to add. 11. (Optional) Repeat steps 2-10 for each additional flow. #### Result The flows now include the forms, which use the language defined in the user's browser settings. Integrate these flows into your environment using a redirect to begin using them. Learn more in [Launching a PingOne flow with a redirect](../integrating_flows_into_applications/davinci_launch_flow_redirect.html).