---
title: Setting up DaVinci Forms for multi-language support
description: This use case covers how to set up the translatable text in forms with multiple langauges that will be translated based on the language settings in the end user's browser settings.
component: pingone
page_id: pingone:user_experience:p1_setting_up_davinci_forms_language_support
canonical_url: https://docs.pingidentity.com/pingone/user_experience/p1_setting_up_davinci_forms_language_support.html
revdate: October 9, 2024
section_ids:
  steps: Steps
---

# Setting up DaVinci Forms for multi-language support

This use case covers how to set up the translatable text in forms with multiple langauges that will be translated based on the language settings in the end user's browser settings.

To set up forms for translations from English to another language:

## Steps

1. To set up the desired languages with custom keys in **User Experience > Languages**:

   1. Enable the languages for which you would like to provide translations, such as **French**, **Chinese**, and **German**. Learn more in [Enabling or disabling a language](https://docs.pingidentity.com/pingone/user_experience/p1_enable_a_language.html).

   2. Make sure that **English** is the default language. Learn more in [Changing the default language](https://docs.pingidentity.com/pingone/user_experience/p1_change_default_language.html).

   3. Export the default language **English** page. Learn more in [Downloading a language bundle](https://docs.pingidentity.com/pingone/user_experience/p1_downloading_language_bundle.html).

   4. Add any additional content in the CSV file for **English**.

      |   |                                                                                                                    |
      | - | ------------------------------------------------------------------------------------------------------------------ |
      |   | The **Key** must start with a `forms.` prefix and can only contain letters, numbers, dashes, underscores, or dots. |

   5. Upload the bundle for **English** with the added key-value pairs.

   6. Export the content in the bundle for the translated language, such as **French**, **Chinese**, and **German**. Learn more in [Uploading a language bundle](https://docs.pingidentity.com/pingone/user_experience/p1_uploading_language_bundle.html).

2. Configure the Form connector capabilities in a flow with the selected keys.

   For example, you can select the message keys for:

   * **Custom HTML Template** Forms using the [HTTP connector](https://docs.pingidentity.com/connectors/http_connector.html)

     ![The custom HTML template UI.](_images/p1-languages-html-template.png)

     |   |                                                                                                                                                                                                 |
     | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
     |   | Click the **Translation** (![The universal translation icon.](_images/p1-languages-translation-icon.png)) icon. A modal with a list of the available keys and their default translations opens. |

     |   |                                                                                                            |
     | - | ---------------------------------------------------------------------------------------------------------- |
     |   | Select the appropriate **Key**. To define a unique key and default translation, select **Create New Key**. |

   * PingOne Forms using the [Form connector](https://docs.pingidentity.com/connectors/form_connector.html)

     |   |                                                                                                                                 |
     | - | ------------------------------------------------------------------------------------------------------------------------------- |
     |   | Learn more in [Using translatable keys](https://docs.pingidentity.com/pingone/user_experience/p1_using_translatable_keys.html). |

     ![An example of what the localized string looks like in the UI.](_images/p1-languages-localized-string.png)

   * Custom error messages in the [Error Message connector](https://docs.pingidentity.com/connectors/error_message_connector.html)

     ![An example of an error message from the UI.](_images/p1-languages-error-message.png)

     When added in the flow, you will see the English texts for the keys. However, when the flow is executed in the browser, the texts associated with the keys will render in adherence with the default language of the end-user's browsers.