Add and manage multiple languages

Add a new language

You can create a new language in the “Customize” - “Languages” section of the Portal.

  • The language name is displayed to identify the language.

  • The language key will be compared to the HTML and browser languages in order to automatically detect the language. It typically consists of the first two letters of the language name (e.g. English = EN).

  • The Copy-From option allows you to decide which language the texts of your new language should be copied from. This helps you to write in the correct translations later. 

  • If you no longer require a language, you can archive it. Archived languages cannot be published for any Guide, but they can always be moved back to the current languages. 

If you already have a Userlane account, you can check this out interactively: 

  • If you are based in Europe ⇨ Start this Guide to see how to manage multiple languages for your content.
  • If you are based in the US ⇨ Start this Guide to see how to manage multiple languages for your content.

Import, translate, and export texts in different languages

To translate your content into different languages you can use our text import/export feature: 

  • Download all your existing texts or all texts for a specific chapter or Guide only, 

  • update the texts for each language, and 

  • upload the new file. 

You can use excel (XLSX) or comma-separated values (CSV) formats for both export and import. 


  • Media elements (like images, videos, links, or info boxes) that appear as <missing element> in the export cannot be created through an upload. 

  • If you change anything in the file (including the original language) the changes will be applied after you import the file (also to your original language)

  • You can import languages one by one by deleting the other "language" columns in the excel file after the export and before the import. You can identify the respective language based on the language code in the first row (eg. "en"). Please don't delete or change anything in the first 2 columns.

If you already have a Userlane account, you can check this out interactively: 

Publish a new language

After creating a language, you can work in this language and publish it.

  • Publish a language for all existing Guides in the “Customize” - “Languages” section via the step options menu next to the language you want to publish. Make sure that all of your Guides have existing texts in this language, before generally publishing it here.

  • Publish a language for specific chapters or Guides only in the manage section using the options next to the respective Guide/chapter. This allows you to translate and publish your Guides in a new language step by step. Make sure to activate a language for the chapter and for the Guide to show the chapter title and subtitle as well as the Guide texts in this language.
    If you are based in Europe ⇨ Start this Guide to learn how to manage your languages in general and for specific content. Alternatively, if you are based in the US ⇨ Start this Guide.

Choose a fallback language

Let's say you created two languages: English and French. For every French and English-speaking end user we will match the corresponding language automatically. To cover every other language, like German or Spanish, you can define a general fallback solution for every chapter or Guide.
⇨ Start this Guide to see where to find the language settings. 

  • Show default language instead (YourDefaultLanguage). This option will show the Guide in the default language you defined in the “Customize” - “Language” section for all those users that don’t have a matching language.

  • Hide this (chapter/userlane) for those users completely. For users without a matching language, this Guide will not appear in the Assistant.

Good to know
  • Showing Guides in the mother tongue of users usually increases the completion rate.

  • Guides texts will be empty in all the other languages when you create a new Guide in one language. You can use the copy from option when creating a new language to avoid empty texts in other languages.

  • When deleting a language, be aware that once you do that we cannot recover any Guide texts in that language for all your Guides. If you don’t need it anymore, you can archive it instead. Then you can always restore it later.

  • Language detection priorities: This article explains the order in which Userlane detects the user language.