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.

Data Disclosure

This application connects your Zendesk Guide (Help Center) account with your Crowdin project to enable translation and localization. Below is a disclosure of the data the app accesses, processes, and stores.

Data the app reads from Zendesk

• Help Center content: Articles, categories, and sections (titles, body content, and metadata).
• Dynamic Content: Items and their variants.
• Account locales: Language settings.
• Images: Embedded in articles.

Data the app writes to Zendesk

• Translated content: Articles, categories, sections, and Dynamic Content variants in your configured target languages.
• Localized media: Localized versions of embedded images.

Data the app stores

• Authentication credentials: OAuth access and refresh tokens issued by Zendesk, used solely to maintain the authorized connection and access the Zendesk API on your behalf.
• Configuration settings: Your Zendesk subdomain and integration configuration (e.g., selected categories, language mappings, sync options).
• Localization assets: Source and translated content is transferred to and stored in your Crowdin project for the purpose of translation.

How data is used

• Data is processed exclusively to synchronize source content for translation and to publish translations back to your Zendesk Guide.
• The app does not sell, share, or use your data for advertising, profiling, or any purpose other than providing the translation/localization service.

Access scope

The app requests only the permissions strictly required for this functionality:

• Help Center read/write (hc:read, hc:write)
• Dynamic Content read/write (dynamic_content:read, dynamic_content:write)

Data retention

Content and credentials are retained while the integration is active. When you disconnect or uninstall the app, the associated tokens and configuration are securely removed and the connection is revoked.