The Localization module empowers you to translate content both within and outside of Usetiful. It comprises an intuitive administration interface for efficient translation management and an API that provides access to translated terms from the system.


You can translate tours, checklists, banners and smart tips.


Localizations are available in the Premium plan or higher.


1. Setting Up Your Languages


The first screen of the Localization module shows the languages you've added.

  • To Add a New Language: Click the +Add Language button and select your desired language from the dropdown menu.


  • To Manage Translations: Use the Edit button next to any language to see all the content that needs translating (Terms).


2. Understanding Terms and Translations


Each language contains terms and translations. It's important to note that all languages share identical terms but different translations.


  • Terms are the original pieces of text in your content (e.g., "Welcome to our site").


  • Translations are the foreign-language versions of those terms.


  • Key Fact: All languages share the same Terms but have different Translations.


Pro Tip: Using a Reference Language. On the language edit page, you can set a Reference language (like English). This displays the original text alongside the new language's field, making comparison and translation easier.




3. How to Add Your Content for Translation


You don't have to manually create the Terms! Usetiful can generate them automatically from your existing content.

  1. Go to the content settings (for your tour, banner, etc.).

  2. In the 'Localization' section, activate the toggle.

  3. Choose the language currently used in that content (e.g., English).

  4. Save the content.

  • What happens next? The system automatically creates a unique Term for every text segment and populates your chosen language with the corresponding translation.

CRITICAL WARNING: If you change the language in the content settings and save it again, the system will overwrite the translations for that new language and erase all previous translations in other languages. Be very careful when changing the content's language setting.





4. Translating Your Content


Once the Terms are generated, you can translate them in the Localization module.

  • Translating Content with Images: If a Term includes a picture, use the Copy button next to the translation field. This will copy the content (including image code) into the translation field, ready for you to change only the text.




  • Filtering: Use the filtering option to focus only on untranslated terms and content.




5. Importing and Exporting Translations


To translate large amounts of text outside of Usetiful:

  1. Use the Export function to download all your Terms in CSV, JSON, or XLIFF format.

  2. Have your translators work on the file.

  3. Use the Import button on the language detail page to upload the translated file back into the selected language.




6. How Users See and How You Preview Translations


After you've completed and saved the translations:

  • User View: Usetiful automatically shows your end-users the content in their correct language, based on the lang attribute in their website's HTML tag.




  • Previewing Translations: You can preview the translated tour in any language you have set up in the Localization module. Watch the video below and learn how to choose different languages for the preview tour.