​
Overview

Userpilot’s translation service gives you the full ability to translate the Checklist content into 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.
If you’re on the Enterprise plan, you can add an unlimited number of languages in Localization. Growth plan users can add up to 5 languages. Starter users will need to upgrade their plan to access the localization feature.

​
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. Screencapture Run Userpilot Io Settings Localization 2025 07 08 17 47 03 Pn 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 the content to and select the desired method of translation.
  1. Automated: Choose the desired language(s) and we’ll automatically translate the content using our state-of-the-art AI-powered language translation service.
  2. Manual: Export the content as a CSV or XLIFF file, send it over to your localization team for translation, and then import 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 Checklist in your desired language since it will be considered the default 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.
  3. Switch on the Live toggle before clicking Publish to ensure your localized version is activated.
You can add as many languages as you want. They will be auto-translated by Google.
Localization Pn
Important note: Enabling the option “Override fields already translated” will override any fields that you translated when editing individual text fields.

​
Manual

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.
  1. Before enabling manual localization mode, make sure that you have fully created your Checklist 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.
Localization3 Pn
  1. Here is what your exported file will look like:
  1. Enter the translation of each row into the ‘Target’ column:
  1. Be sure to save your file as CSV UTF-8 (Comma delimited) when you have finished translation to your desired language.
  2. 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.

​
Add Local

When clicking Add 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. Localization2 Pn
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.