Localization

The Algolia integration for Zendesk supports help centers in many languages.

The Algolia integration for Zendesk supports help centers with multiple languages. Users see the results in the language they select.

Supported languages

The Algolia integration supports these languages (locales):

• ar: العربية / Arabic
• ar-eg: العربية (مصر) / Arabic (Egypt)
• bg: Български / Bulgarian
• cs: Čeština / Czech
• da: Dansk / Danish
• de: Deutsch / German
• de-at: Deutsch (Österreich) / German (Austria)
• de-ch: Deutsch (Schweiz) / German (Switzerland)
• el: Ελληνικά / Greek
• en-au: English (Australia)
• en-ca: English (Canada)
• en-gb: English (Great Britain)
• en-ie: English (Ireland)
• en-us: English (United States)
• en-150: English (Europe)
• es: Español / Spanish
• es-es: Español (España) / Spanish (Spain)
• es-mx: Español (Mexico) / Spanish (Mexico)
• es-419: Español (Latinoamérica) / Spanish (Latin America)
• fi: Suomi / Finnish
• fr: Français / French
• fr-be: Français (Belgique) / French (Belgium)
• fr-ca: Français (Canada) / French (Canada)
• fr-ch: Français (Suisse) / French (Switzerland)
• fr-fr: Français (France) / French (France)
• hu: Magyar / Hungarian
• id: Bahasa Indonesia / Indonesian
• it: Italiano / Italian
• ja: 日本語 / Japanese
• ko: 한국어 / Korean
• nl: Nederlands / Dutch
• nl-be: Nederlands (België) / Dutch (Belgium)
• no: Norsk / Norwegian
• pl: Polski / Polish
• pt: Português / Portuguese
• pt-br: Português do Brasil / Brazilian Portuguese
• ro: Română / Romanian
• ru: Русский / Russian
• sk: Slovenčina / Slovak
• sv: Svenska / Swedish
• th: ไทย / Thai
• tr: Türkçe / Turkish
• uk: Українська / Ukrainian
• vi: Tiếng Việt / Vietnamese
• zh-cn: 简体中文 / Simplified Chinese
• zh-tw: 繁體中文 / Traditional Chinese

Update translated strings

If you want to update some translations, edit the translation object in the algoliasearchZendeskHC function.

For example:

JavaScript

translations: {
  placeholder: {
    de: 'In unserem Help Center suchen',
    'en-us': 'Search in our Help Center',
    fr: 'Recherchez dans notre Help Center'
  }
}

Translatable strings

The following code lists all available translatable strings with the default values for the en-US locale:

JavaScript

translations: {
  categories: {
    'en-us': 'Categories'
  },
  change_query: {
    'en-us': 'Change your query'
  },
  clear_filters: {
    'en-us': 'clear your filters'
  },
  format_number: {
    'en-us': function (n) { return n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ','); }
  },
  filter: {
    'en-us': 'Filter results'
  },
  nb_results: {
    'en-us': function (nb) {
      return this.format_number(nb) + ' result' + (nb > 1 ? 's' : '');
    }
  },
  no_result_for: {
    'en-us': function (query) {
      return 'No result found for ' + this.quoted(query);
    }
  },
  no_result_actions: {
    'en-us': function () {
      return this.change_query + ' or ' + this.clear_filters;
    }
  },
  placeholder: {
    'en-us': 'Search in our articles'
  },
  quoted: {
    'en-us': function (text) { return '"' + escapeHTML(text) + '"'; }
  },
  stats: {
    'en-us': function (nbHits, processing) {
      return this.nb_results(nbHits) + ' found in ' + processing + ' ms';
    }
  },
  search_by_algolia: {
    'en-us': function (algolia) { return 'Search by ' + algolia; }
  },
  tags: {
    'en-us': 'Tags'
  }
}

Localized tags

You can prefix your tags with a locale, separated by a colon. For example, if the tags of an article are:

JavaScript

[ 'Wow', 'en:Awesome', 'en-gb:Good', 'fr:Incroyable' ]

The indices for each locale only contain the tags matching their locale:

Locales	Tags
All fr locales	{ "label_names": ["Incroyable"] }
en-gb	{ label_names: ["Good"] }
Other en locales, for example, en-us	{ "label_names": ["Awesome"] }
All other locales	{ label_names: ["Wow"] }