Search

Using Dynamic Content in your Zendesk help center

Jordy Veldhuis
Jordy Veldhuis
  • Updated

With Dynamic Content, you centrally manage all texts, buttons, and links in your Zendesk help center theme in multiple languages without adjusting code. Read in this article how to create and use it in the help center.

What is Dynamic Content and how do I create it?

A Dynamic Content item is a reusable text or HTML block with a name. You reference it via an expression in your .hbs template, and Zendesk replaces that expression server-side with the correct text before the page loads in the browser. 

Each item has a default language, and you can add language variants for every language your help center supports. When a visitor views the help center in German, Zendesk automatically shows the German variant. If that variant does not exist, Zendesk falls back to the default language.
 

You need administrator rights to create DC items. Follow these steps:

  1. Go to Admin Center → Workspaces → Agent tools → Dynamic content.
  2. Click on Add item.
  3. Give the item a clear name without spaces, e.g., theme-contact_button_text or theme-header_link_1_url.
  4. Choose the default language (e.g., English if that is your base language).
  5. Enter the content.
  6. Click on Add variant, choose the language (nl, de, en-US), and enter the translation.
  7. Repeat step 6 for each additional language your help center supports.
  8. Click Create to save.
     

Using DC for text and buttons in .hbs templates

For visible texts, labels, and button texts in your theme, use the DC expression directly as the content of an HTML element. Open the desired .hbs file in the theme editor (Knowledge/Guide Admin → Customize design → Edit code) and insert the expression where the text should appear.

Using DC items in text:

<p>{{dc 'theme-homepage_intro_text'}}</p>

Using DC items in a URL:

<a href="{{dc 'theme-header_link_1_url'}}">
 button
</a>

Using DC items in theme settings:

In the theme settings, you do not need to use 'dc' or quotes:

schermafbeelding dynamic content

Zendesk automatically fills in the correct language variant based on the active language of the visitor. A Dutch-speaking visitor sees the Dutch text, an English-speaking visitor sees the English.

Do you have questions about Dynamic Content in your help center or need assistance with implementation? Contact cloudmotion.