This integration is available from the Pro plan and above.

Use this integration 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.

Setting up

Connecting Zendesk to Lokalise

To set up the integration for your project:

  1. Navigate to the More > Apps.

  2. Click Connect beneath Zendesk Guide.

  3. Click Connect again and enter your Zendesk subdomain (for example, mycorp_support).

  4. Allow Lokalise to access your Zendesk project.

Importing items

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:

Performing translations

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

When the translations are done, return to the integration 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

First, you must add the languages to which you want your help center translated. It can be done at Zendesk Support, under Admin > Settings > Account > Localization.

2. Add languages to help center.

As you've enabled the required localizations, you need to add them to your help center. Navigate to help center settings > Guide settings and select the languages once again.

Did this answer your question?