This feature is available from the Pro plan and above.
Dynamic content is available only on the Zendesk Professional plan and higher.
Zendesk Dynamic Content (ZDC) allows you to create reusable content that can be referenced in automations, macros, triggers, and system-generated messages, such as email notifications for account creation.
This feature helps streamline multi-language support by automatically displaying the appropriate language version to users. Dynamic content is represented by a placeholder like {{dc.my_placeholder}}.
Preparations
Before translating dynamic content, decide which languages you want to support.
Switch to Zendesk Support using the menu in the top right corner.
Then go to Admin > Settings > Account > Localization.
Click Additional languages and select the languages you need.
Once selected, save the changes.
Integrating Zendesk Dynamic Content with Lokalise
Create Lokalise project
If you haven’t already, create a Marketing and support project in Lokalise.
Enter a project name, select the base and target languages, and choose Zendesk Dynamic Content from the Content integration dropdown.
Click Create project to finalize the setup.
Installing the app
Once the project is created, you should be redirected to the Content management tab. If this doesn’t happen, open your Marketing and support project manually, go to the Content management tab, and click Install.
A dialog will appear asking for your Zendesk subdomain. If your help center URL is mycorp.zendesk.com, then the subdomain is mycorp.
Enter the subdomain and click Authorize.
Once authorized, you will see a list of all Zendesk Dynamic Content (ZDC) items available for import.
Importing items from ZDC to Lokalise
This app supports automated import. For more details, refer to the corresponding article.
Once items are synchronized, they must be imported into Lokalise for translation. You can filter the items using the Filter dropdown or refresh the synchronization by clicking the Refresh icon.
To begin importing, select one or more items from the list and click Import selected.
A dialog will appear where you can choose which languages to import.
If a language does not exist in your Lokalise project, it will be created automatically. Enabling Overwrite updated translations will replace existing translations in Lokalise with the latest content from Zendesk.
Click OK to start the import. The process will run in the background, and you can monitor its status on the Activity page.
Once the import is complete, open the Lokalise project editor to begin translating as usual.
Performing translations
Once the items are imported into Lokalise, you can begin translating them.
Each item will have a separate translation key, and the following tags will be assigned:
Zendesk Dynamic Content
The name of the ZDC item (e.g.,
forgot_password)The name of the ZDC placeholder (e.g.,
{{dc.forgot_password}})
These tags can be used to filter translation keys, making it easier to manage and organize your translations.
Exporting items from Lokalise to ZDC
This app supports automated export. For more details, refer to the corresponding article.
Once your translations are complete, export them back to Zendesk. Open the Content management tab, select the items you want to export, and click Export selected.
A dialog will appear where you can choose the languages to export.
If needed, enable Mark new content as active and click OK. The export process will run in the background, and you can track its progress on the Activity page.
After the process is complete, return to Zendesk to verify that your dynamic content has been translated correctly.
