Zendesk Guide localization with Crowdin

Translate your Zendesk Guide content with ease. Setup integration once, define your localization workflow and spend less time managing translations.

Guide enables you to provide end users with a complete self-service support option and empowers agents to better help customers.

Features at a glance

• Knowledge base translation.
• Manual content synchronization before and after translation.
• Auto-sync of source content and translations.
• WYSIWYG file preview for translators.
• Quick sync and translation of even minor content updates, like a new sentence or a changed word.

Zendesk Guide translation connector overview

Setting up the Zendesk Guide connector

After installing the application, you will find it in your project Integrations section.

Follow the instructions on the screen to connect your Zendesk Guide account.

Manual synchronization

To import content for translation from Zendesk Guide, follow these steps:

1. Open the Zendesk Guide integration.
2. In the Zendesk Guide section (right panel), select the files that should be translated.
3. Click Sync.

To export translations to Zendesk Guide, follow these steps:

1. Open the Zendesk Guide integration.
2. In the left section, select the files that will be synced to Zendesk Guide.
3. Click Sync to Zendesk Guide.

Auto content synchronization

To automatically import content for translation from Zendesk Guide choose files and click Scheduled sync in the right panel in the Zendesk Guide integration. The file you chose will be pushed once at a scheduled time (by default, it is done once a day). The same button is used to export translated files from Crowdin to Zendesk Guide (in the left panel). You may disable this by clicking Disable Sync.

Managing Image Localization for Zendesk Guide Articles

The Zendesk Guide app allows for seamless synchronization of articles and their associated image assets between Zendesk Guide and Crowdin, ensuring a consistent and localized user experience across all languages. Below is a guide on how to manage image localization for Zendesk Guide articles using the Crowdin Zendesk app.

Workflow for Image Localization

Prior Settings:

• Before syncing your Zendesk Guide articles to Crowdin, select Translate image assets in the Zendesk Guide app Settings within Crowdin.

• Open your Crowdin project settings and select Allow Offline Translation to allow your translators to download source files to their devices for offline translation.

Syncing Content from Zendesk Guide to Crowdin:

• Upon syncing, your Zendesk Guide articles and their embedded images are uploaded to your Crowdin project. Images found in your articles are placed in separate folders within Crowdin, organized in a way that makes them easily identifiable and accessible to translators.

Adding additional context:

• Add necessary details and instructions for your translators using Context.

Translating Image Assets:

• Since the image translation process involves external tools, translators download the images from Crowdin, use their preferred graphic editing tools to localize the content within the images, and then upload the localized versions back to Crowdin.

Syncing Translations from Crowdin to Zendesk Guide:

• Once the image assets are localized and uploaded to Crowdin, you can push the translations back to Zendesk Guide. The Zendesk Guide app intelligently replaces the original images in your Zendesk Guide articles with localized versions, based on the target language of each article.

• This automatic replacement ensures that each article in your Zendesk Guide displays the appropriate images for the viewer's selected language.