This feature is available from the Pro plan and above.
Use this app to sync your Zendesk Help Desk with Lokalise. It's a good idea to use a separate Lokalise project for Zendesk localization. Lokalise can only sync categories, sections and articles that already exist in your help center.
Your profile should have permissions to modify Zendesk guide content to properly export translated items.
Connecting Zendesk to Lokalise
To set up the app for your project:
Navigate to the Apps page.
Click on Zendesk Guide and press Install.
Click Connect and enter your Zendesk subdomain (for example,
Allow Lokalise to access your Zendesk project.
Zendesk API has certain limitations when working with content blocks. Specifically, you might not be able to export translations containing content blocks back to Zendesk.
This app also supports automated import. You can learn more in the corresponding article.
Once you authorize, the list of sections, categories and articles will appear. Select the required items and press Import selected to download the chosen content to your Lokalise project for further translation.
Missing languages will be automatically added into your Lokalise project. Choose one or more languages and decide whether you'd like to update already downloaded items with the values from Zendesk:
Click OK once you are ready. Please note that the import process will be performed in the background, and you can check its status on the Activity page.
You can narrow the scope using the Filter dropdown or use the search box in the top right corner:
After the items are downloaded and new keys are created, you may proceed to the translation process as usual. The newly created keys will be assigned with a handful of tags as shown in the screenshot:
Specifically, each key has the following tags:
"Zendesk Guide" — specifies that this content is related to Zendesk Guide.
"title" or "body" — specifies which part of the article the key belongs to.
A tag specifying the item type (article, section, or category).
A tag named after the corresponding post, section, or category.
Export and import
Export to Zendesk Guide
This app also supports automated export. You can learn more in the corresponding article.
When the translations are done, return to the app page and select the items you want to export to Zendesk. Next, click the Export selected button.
Choose the languages to export and tick Don't export empty translations if needed. The selected languages will be updated in Zendesk.
Import from Zendesk guide
If any changes were made in Zendesk, you can update the existing Lokalise keys by importing items from Zendesk. To achieve that, choose one or more linked items and click Import selected.
Setting up Zendesk Help Center
1. Enable localizations
As an optional step, add the languages to which you want your help center translated. It can be done at Zendesk Admin Center, under Account > Localization.
2. Add languages to help center.
Add languages to your help center by navigating to Help center settings > Language settings and selecting the languages (press Add new language to create more languages):