As companies grow and expand into global markets, companies look to provide their application in local languages. Pendo can help you deliver your in-app messages in the languages you support as well.
To use this feature, you will need to have Pendo Administrator Permission to access and manage your app’s localization settings within Subscription Settings.
Setup your App’s Localization Settings
Navigate to Subscription settings and choose your app. Choose the “Localization Settings” tab and enable Localization Settings.
Language Preference Metadata - You will need to pass data into Pendo at a visitor level so Pendo can use it to serve the right language Guide to the appropriate visitor. This data needs to flow into Pendo via agent visitor metadata. The field name of the data, and the values of that data are up to you. If you aren’t passing any language metadata to Pendo, you can use the default “Language” metadata option which Pendo provides out-of-the-box. This metadata option will look at the default language setting that each user sets up in their browser. Pendo highly recommends that you use your own values for accuracy, but the browser language metadata can be used if you don’t have another option.
- Missing Translation Language Behavior - This is an important setting that has some implications. This setting tells Pendo what to do if a visitor is eligible for a Guide, but has a language code that doesn’t match a translated version of that Guide. This could be because that language has not yet been translated or it’s a language that is not setup in your Pendo subscription. It’s important to remember that this setting could result in a user to not see your Guides at all if they are coming in with a language setting that doesn’t match any of your preferences.
Export Your Guide
To start, create a Pendo Guide in English as desired. Guides need to be created with the new Pendo guide building experience.
Once you’re done creating your Guide, navigate to the “Localization” tile in the Guide Details view.
Click on the “Edit” option to export your Pendo Guide. You will see your default language guide and an export option. Click on the export button to download your Guide in XLIFF 1.2 format so it can be translated.
This file will contain your Guide content as strings that can be translated into your desired languages. If it is a multi-step guide, strings from all steps will be included in that same file.
Import Your Translated Files
Once you have sent off your file for translation, and receive your translated files (one file per guide per language) you can import them from the same “edit” window.
Test & Preview Your Translated Guides
After you import your files, use the language chooser at the top of the Guide Settings to preview your Guide in your desired language.
Once you’re happy with your Guide, schedule or publish it when you’re ready.
Frequently Asked Questions
How will this affect my old guides when I turn on localization?
Guides created in the old Pendo designer can not be localized. Similarly, the “Missing Translation Language Behavior” setting will not apply to the old Pendo version of guides (so old style guides will still show up to a user even if the fallback setting is set to don’t show guides if language is not yet translated).
What file type is supported?
XLIFF 1.2 format only. Need a different format? We’d love to hear that feedback.
What languages are supported?
- Chinese (Hong Kong)
- Chinese (PRC)
- Chinese (Taiwan)
- English (UK)
- English (US)
- French (Canada)
- French (France)
- Portuguese (Brazil)
- Portuguese (Portugal)
- Spanish (Latin America)
- Spanish (Spain)
Does Pendo translate the Guides for me?
No, you use your existing guide translation processes. We provide a file which you send off, and then upload the resulting files with translated strings in them.
Can I author a Guide in a different Language?
Yes. If you want to author individual guides in a different language, you can do so by clicking the "edit" link near the Export button in the localization edit card on the guide details page. To set your default language for all new Guides from English, contact your Pendo Representative to make that change.
Are there additional analytics by language?
Coming soon. Pendo is working on the Analytics side of localization to allow you to see analytics sliced by language version seen of a guide. This is expected to launch in March of 2019 so analytics will currently show data with all languages combined.
Can I translate my Resource Center?
Coming soon. Guide Center is now called the Resource Center. Localization options for the Resource Center isn’t available yet.
What is the minimum Agent version needed to use Localization?
2.15.15 or above is recommended. Localization leverages the Visual Design Studio so the minimum version is required for this feature.