API Blog Sign in

Translations

Helpdesk supports multi-language knowledge bases. Each article has a canonical version in the default locale, and translations are linked child articles in other languages.

How translations work

  • Each brand has a default locale and a list of supported locales
  • The original article is the canonical version
  • Translations are separate articles linked to the canonical via parent_article_id
  • Each translation has its own title, body, status, and version history
  • Translations share the same section placement as the canonical article

Creating a translation

  1. Open a published article in the editor
  2. Open the Translations panel
  3. Click Add Translation and select a language
  4. Optionally enable auto-translate to pre-fill the content
  5. Edit the translated content and publish

Managing translations

The article list shows locale flags next to each canonical article, indicating which translations exist. Click a flag to navigate directly to that translation’s editor.

Use the canonical only filter to show only source articles (hiding individual translations from the list). This gives a cleaner view of your content inventory with translation status at a glance.

Portal language resolution

When a visitor accesses the help center, the portal determines the language using:

  1. URL parameter — ?locale=es in the query string
  2. Accept-Language header — the browser’s language preference
  3. Brand default — falls back to the brand’s default locale

If a translation is not available in the requested locale, the portal serves the default-locale version.