Overview

UserGuiding has text support enabled for multi-language applications for all languages and scripts available within modern browsers.

Suppose you want to display your content in different languages. In that case, you can turn on the Localization feature for your materials and upload the translated versions of your content by following the steps below.

Setting Up Localization

First, you must configure the languages you want to use for your content.

• Go to the Localization tab under your Settings
• Click on the +New Language button

• Select the language
• Click "add segmentation criteria" and select one of your existing segments

Important: You need to create user segments based on a language attribute. You can use the default language attribute, which depends on users' browser cookies, or opt for a custom attribute. We recommend using a custom attribute for greater reliability.

Localization for Guides, Hotspots, Banners, Checklists, and Resource Centers

Enabling Localization for a Guide, Hotspot, Banner, Checklist, or Resource Center

When you visit the details page of a Guide, Hotspot, Banner, Checklist, or Resource Center, switch to the Localization tab at the top. Here in the dropdown list, you will be able to choose among the additional Languages that you have enabled for your account. Once you choose the desired language, activate Localization of the material for the chosen language.

Once you activate a language, you will see the list of all the fields that belong to that specific material on the Page. Each field needs to be translated to the new language individually.

Using the Auto-Translate Function

You can use the Auto-Translate Function to translate each field individually or translate all of the fields at once using the Auto-Translate Button on top. This function will translate the original content into the desired language automatically, also keeping the HTML attributes that belong to the content.

For Banners, Checklists, and Resource Centers, you can translate each field manually or use the Auto-Translate All button. Note that CSV download/upload is not available for these materials; use the inline translation fields or Auto-Translate instead.

For Checklists, translatable fields include: title, subtitle, item headers, launcher text, locked items message, dismiss button texts, completion animation header and body, and Page URL item URLs.

For Resource Centers, translatable fields include: title, subtitle, search placeholder, no-result message, module and group headers/descriptions, rich content body and cover image alt text, External URL module URLs, launcher text, and tab names for Knowledge Base, Product Updates, and AI Assistant.

Note: URL fields (Checklist Page URL items and Resource Center External URL modules) are translatable but manual-only. The per-field Auto-Translate button is disabled for URLs, and they are excluded from Auto-Translate All.

Manual Translation via Downloading and Uploading CSV Files (UTF-8)

Note: CSV-based translation is available for Guides and Hotspots only. For Banners, Checklists, and Resource Centers, use the inline translation fields in the Localization tab.

To translate the content manually, you'll need to download the translation file of your content. Please make sure the content of your original material is fully ready to be localized before downloading the file.

• Click the CSV Download Button on Top
• In the CSV file, you'll see all the text content of your original material, including the requisite or custom buttons, images, video or HTML embed codes, etc.
  

Translating and Uploading the Content

• Open the CSV file with an editor
• Fill in the "translated" column for each text
• Save your file as CSV with a new name
• Go back to the localization settings of your material
• Upload your translated file using the CSV Upload Button

Previewing and Publishing the Material

Each Localized material can be previewed in the languages you have translated into.

For Guides and Hotspots, you can click the Preview button on top of your page. You will be redirected to your platform and can preview the material through the UserGuiding extension.

Preview in Editor (Banners, Checklists, and Resource Centers)

For Banners, Checklists, and Resource Centers, you can preview translations directly in the material editor. On the Localization tab, click Preview in Editor, then select a language from the dropdown that appears above the editor settings. The editor will display translated content for the selected language, and settings are grayed out while previewing. Click Back to return to the Localization tab. The selected language persists across editor tab switches and page refreshes.

Whenever you add new content to your Checklist or Resource Center, remember to translate the new items. You can enable Show only missing translations to identify any content that still requires translation quickly.

If you're happy with the result, don't forget to Save and Publish your changes.

📌 Important Notes

• These features are available for Growth plans and above.
• You do not have to add the default language you used to create your original materials as a new language.
• While editing your Resource Center, the editor and the Product Updates/Knowledge Base module previews always show content in your account's default language even if the published Resource Center is set to a different language for your users. To preview the translated content correctly, use the Localization tab and enable Preview in Editor in the target language.
• If you are using the Manual Translation via CSV (Guides and Hotspots only)
• • You must not have any blank rows under the "translated" column.
  • You must not change anything in the "default" column.
  • You must upload separate files for each language you translate. You may not add new columns to the original file.
  • The file must be in CSV format, and the file encoding must be UTF-8 to be uploaded successfully.
  • Please note that Dashboard Analytics will be displayed only by materials, not by the translated languages.
  • You do not need to select language-based segmentation for your materials. The material will be displayed depending on the language settings you configured under the Localization page.

🤓 Best Practices

• As editing a CSV file and protecting the file type after saving might be challenging, we suggest you use a web tool like this to refrain from any potential mistakes & errors. And if you're using a spreadsheet tool, remember to export your finished files in CSV (UTF-8) format.
• If you have localized images, GIFs, or videos, you can add their file locations or embed their codes into the corresponding row under the translated column in the file.
• Please ensure your material is fully ready to be localized. Editing your materials would also require extra adjustments in the translation files.
• Localizing your materials while inactive is always better for better testing purposes.
• If you want to make changes to your materials, please make sure you restore all the translated files as a reference for future use.