Localize Checklist Content

Overview

Userpilot's translation service gives you the full ability to translate the Checklist content in different languages. You can provide on-demand help for your users in the right language for them. This can be easily done with a click of a button.

Common use cases

• Non-English speakers can now go through their Checklist tasks more easily.
• The ability to target a global audience by delivering the same content in multiple languages.

Setup your language localization parameter 

To accurately localize your Checklist, Userpilot determines which language to show to your end-users based on the language localization parameter. This parameter can be changed from the Localization tab under your account settings.

You can use a property sent to Userpilot via your installation as your localization parameter taking into consideration that the name of the user property must be 'locale_code' and any used language should follow the ISO 639-1 code standards as shown in the example below. If you're not passing any properties, you can use the default property 'Browser_Language' which is automatically tracked by Userpilot. This parameter will look at the default language setting that your end-user sets up for their browser.

Types of localization 

To start localizing your Checklist content after choosing your desired localization parameter, you can click on the localization tab in the Checklist, then click on the language that you would like to translate content to, and select the desired method of translation.

1. Automated – choosing the desired language(s) and we'll automatically translate the content using our state-of-the-art AI-powered language translation service.  
2.  Manual – exporting the content as a CSV or XLIFF file, sending it over to your localization team for translation, and then importing it back to Userpilot.

Important note: The translated content cannot be retrieved once you change the translation method from Automated to Manual and vice versa. 

Step-by-step localization guide

Pro tip: We recommend localizing your content only after it is fully built, designed, and tested.

Automated

1. Create your content in your desired language since it will be considered the base for translation, then head over to the localization tab and select the language you want your content to translate to.
2. You can click on the "Auto-Translate" button to auto-translate all the content in the Checklist. You can also auto-translate each field individually by clicking on the translation icon that appears in the test field. 

Checklist Localization gives you the benefit of providing translation to your users based on their Locale Code or Browser Language. 

You can add as many languages as you want. They will be Auto-Translated, by Google.

If you want the translations to be more accurate, you could add the translation yourself by exporting your files first, editing them, and then importing them. This case could also be used if Google doesn't have your language. 

Important note: Enabling the option "Override fields already translated" will override any fields that you translated when editing individual text fields.

3. Once you are confident that your content looks fine, just toggle the "Live" option and a green indicator should appear for that specific language.

When adding a Locale, the button will directly take you to 'Settings' >> 'Localization' where you can enable Localization for your content and see the Locale Codes that have been passed to you. 

4. Publish the changes and you're all set! 

Note: If the Checklist is unpublished you will see a "Publish" button. In case the Checklist is published, you will see a "Publish Updates" button.

Manual

1. Before enabling manual localization mode, make sure that you fully built your content in your desired language localization mode.
2. Click on the export button to download the CSV or XLIFF file. The file for each of the languages will contain the content as strings.

3. Here is what your exported file will look like: 

4. Enter the translation of each row into the 'Target' column:

5. Be sure to save your file as  CSV UTF-8 (Comma delimited) when you have finished translation to your desired language.

6. Once you are confident that your content looks fine, just toggle the "Live" option and a green indicator should appear for that specific language. 

7. Publish the changes and you're all set!

Note: If the Checklist is unpublished you will see a "Publish" button. In case the Checklist is published, you will see a "Publish Updates" button.

With Localization, you are done with setting up and creating your Checklist. It's Time to Publish it!