Translate Zendesk

This Zendesk application integration guide shows you how to translate Zendesk applications in a few easy steps. Follow this tutorial to create a multilingual Zendesk application translated to other languages for your international customers.


Below is a step by step guide for integrating Localize into your Zendesk Help Center ("Guide").

If you do not have a Localize Project yet, signup here!

1. Select "Guide"

Select the Zendesk Products icon then select Guide from your Zendesk Dashboard.

2. Select "Guide admin"

Select the Guide admin link which is to the left of the Zendesk Products icon.

3. Customize Design

Click the "Customize design" button in the left sidebar.

4. Customize Theme

In the Live Theme panel click Customize.

5. Select "Edit code"

Confirm that you wish to edit the code (only seen the first time).

6. Select the "Document head" file.

7a. Add the Localize Code Snippet

Add the following code snippet below any existing code in the file.

<script src=""></script>
<script>!function(a){if(!a.Localize){a.Localize={};for(var e=["translate","untranslate","phrase","initialize","translatePage","setLanguage","getLanguage","detectLanguage","getAvailableLanguages","untranslatePage","bootstrap","prefetch","on","off","hideWidget","showWidget","getSourceLanguage"],t=0;t<e.length;t++)a.Localize[e[t]]=function(){}}}(window);</script>

    key: '[[app:key]]', 
    rememberLanguage: true,
    // other options go here, separated by commas

Make sure that your Project Key is shown next to "key: ????".

7b. Add Initialization Options

Add any desired options to the Localize.initialize() call above, check here for the full list of possible options.

Some popular options include:

  • autoApprove - use to fully automate your translation workflow
  • localizeImages - allows for localization of images in your site

8. Click the "Publish" button.

9. Reload your website.

  1. Visit your website in a browser.
  2. Select one of your target languages using the language-switching widget.
  3. Refresh the page.
  4. Lather, rinse, and repeat, for each page on your site.

Localize will automatically begin to detect new content on the pages that you visit and will bring it into your dashboard.

10. Approve phrases

Then head on over to the Manage Phrases page to approve phrases in the Localize dashboard.

11. Phrases not showing up?

If you are not seeing phrases show up in your Pending bin in the Localize dashboard, follow the troubleshooting instructions here.

Need Help?
Contact support for custom integration help or troubleshooting!