To start requesting translations, make sure you have read through the steps on how to integrate your Help Center with Unbabel and have your language setup properly configured. A language will only show up as available to translate to if it matches the source language to form a supported language pair.

You can access our integration web page at https://kb.unbabel.com. You can access the page directly, using your Customer Portal credentials, or log in to the Portal first and then select the Zendesk Guide app from the Apps launcher button in the top right corner of the screen.

Once you log in, Unbabel will automatically screen your Help Center for the article's status. We will typically look for new articles, articles lacking translations in your supported languages, and changes to articles since the last translation was delivered by Unbabel (whether they are Published or Drafts).

Unbabel will only detect translations that it has performed itself. If your article has both a default version and one or more translations completed outside Unbabel, we will not have visibility over them.

Be sure to only load and select your articles after you finish and save all intended changes in Zendesk. When https://kb.unbabel.com launches, it will capture the instant version of your Help Center. Subsequent changes after loading won't be reflected.

Automatically selecting articles for translation

As the screening is completed, we will summarize all articles in need of translation (languages missing, changes made, etc). You have the possibility of immediately proceeding with a translation request for these articles if you:

1 - Click on the Select Articles button. All articles meeting these criteria will be selected.

2 - Click Request translation.

3 - Select the languages you want to translate to.

4 - Click Order transaltion.

Manually selecting articles for translation

It is possible to manually select which articles are due for translation, by navigating the left pane through the category and section paths. The parent folder will be the selected Zendesk brand, identified by its subdomain. Expanding the folder will reveal all categories, and picking a category will display all the sections and subsections contained therein. 

You are able to find your articles once you select a section. Articles within the section will display in the center panel, along with their status. Articles that have been subject to changes since the last translation, and sections and categories containing such articles will be identified by a red dot preceding them. You can also check the article's status for additional clues:

• "No translations yet" - The article hasn't been translated at all
• "Translation in progress" - The article is still being translated in at least one of the selected target languages
• "Translated" - The article was successfully translated into the listed target languages
• "Changed" - The source article was edited after being translated

All articles will display a center column listing the languages Unbabel has translated them to in this view.

Clicking an article title will display its translation details, namely, the languages it has been translated to, the status of those translations, and the date of the last translation request.

Confirming the translation request

After you've selected the articles you wish to translate, you may click on Request Translation on the top right corner of the screen. This will open a new window.

1 - Confirm which articles should be translated by selectig or deselecting or deselecting them on the list.

2 - Confirm your source language.

3 - Pick your target languages from the drop down list.

4 - Click on Order translation.

From here on, all you need to do is wait until they are completed! Once they are, a translated version for the article will become available as a draft in Guide Admin.

Category and section titles and descriptions

If you are looking into a child folder, you will find a row containing the info about its parent folder above each view. It will read the section name (if you are looking at listed articles) or the category name (if you are looking at sections). The checkbox before the section/category name will allow you to select/deselect all child items (that is, all sections and articles within a category, and all articles within a section). 

We will translate any section and category titles and descriptions for which at least one child article has had one translation requested. If this has not happened before, it is normal that you find the checkboxes selected even when selecting a single article for translation.

Character limitations

Zendesk has a native limitation on the number of characters an article title may have, set at 255 characters. While your English title may be under this limit, due to the phenomenon of text expansion during translation, the limit may be exceeded. Text expansion consists of the target language taking more space and/or using more characters than the original source once the content is translated.

On average, foreign languages use up 30% more characters than English. As such, we recommend that whenever possible, you don't exceed 150 characters in the original EN title of your articles.