Overview
Localization makes it easy to deliver in-app messages in a variety of languages. With localization enabled, Reseller Adopt End Users (AEUs) can create guides in their preferred language, export an XLIFF/XLF file (the standard format for translation data), translate the guide contents outside of Reseller Adopt, and then import the translation(s) back into the guide settings. Pendo Reseller Adopt uses the language metadata the Partner passes through in the installation snippet or browser metadata to display the appropriate language to your user.
Note: Localization settings changes made in the Partner's subscription affect all Reseller Adopt End User (AEU) subscriptions.
Requirements
- Pendo Subscription Admin users can access and manage your Localization settings in Subscription Settings
Setup Localization Settings
Note: These steps only apply to Partner subscriptions.
1. Localization Settings are app specific. Go to Subscription Settings in the Settings menu and select an app.
2. Enable Localization in the Localization Settings tab. This shows the Localization Settings that are applied to all Guides in that app.
Language Preference Metadata
In order for the correct translation to be delivered with the guide, the Reseller Adopt End User must have access to the metadata field that determines the visitor's language. This means only those values that are marked as "Adopt Enabled" are allowed to be selected.
Pendo determines which language to serve visitors based on the Visitor’s local metadata. Use the default language metadata that Pendo collects from the Visitor's browser or set up a custom language metadata value in the Metadata tab. The metadata field name and values of that metadata are up to the Partner.
Select the language metadata value in the drop down menu.
Note: Pendo highly recommends that you use your own values for analytics accuracy but a visitor’s browser language metadata can be used if you don’t have another option.
Supported Guide Languages
1. Click on + Language to add all the languages you will need for Guide translations.
2. Select the language from the drop down menu. The list shows all available languages and the default metadata value collected by the browser for that language.
3. Change the metadata to match your custom language metadata value if necessary.
4. Click Add to save the new language. Repeat this process until you have added all of your languages.
Supported Languages
Supported Languages shows a list of all added languages. Hover over a language to show the Edit and Delete buttons.
Note: Supported languages cannot be deleted by a Partner's organization. Once a language is added by the Partner, it is automatically shared with all of their Reseller Adopt End Users. The Partner will not know which organizations have guides translated into which languages and could therefore break guide delivery for an organization if they delete a language currently in use.
Missing Translation Language Behavior
Missing Translation Language Behavior (1) controls if a visitor sees a Guide in the default language when their translated language is not available for that Guide. This could be because that language has not yet been translated or is not set up in your Pendo subscription.
Show Default Language if Translation is Missing (2) can’t be turned off in a Partner’s subscription. This setting will allow visitors to see guides in the default language if they have a language setting that doesn’t match any of the current translations. As these supported languages are controlled by the Partner, but the guide translations are controlled by the AEUs, Show Default Language if Translation is Missing can't be disabled in the Partner's subscription to avoid inadvertently disrupting guide delivery for their AEUs.
For example, a visitor may set their preferred language to Korean in their browser. However, the AEU does not translate their guides into Korean. With this setting enabled, the visitor will still receive guides as they will be displayed in the guide’s default language since the translation to Korean is missing.
Localization Tile
The localization tile can be accessed on the Guide Details and Resource Center Module Details page. Once localization has been enabled for an organization, and their Partner has added the requested languages, the AEU must import translations in the desired language (1). When the translations are successfully imported the language will appear in the Translated section. To learn more about localization, view this Localization article.