Skip to main content
Support

Customizing How Machine Translations Work

Control machine translations in HelpDocs: exclude brand names from translation or map specific words to custom translations under Settings > Languages > Machine translation.

River Sloane
Updated by River Sloane
3 min read

Table of Contents

Machine translations are a super quick and easy way to get your docs into a different language (or languages ✨) without having to get a third-party involved.

Sometimes you want to control what gets translated and what doesn't. Or maybe you want to translate a certain word into something that fits your brand better in that language.

Good news! Both are done from the same list, Your translations, under Settings > Languages > Machine translation. Here's how it works.

The Your translations section for the German version, with Brightdesk set to stay untranslated and Dashboard set to translate to Übersicht
Your translations are set separately for each of your other languages. In your default language, the section asks you to Switch to another language instead of showing the list.

Excluding Words from Being Machine Translated

  1. Pick the language you want to customize from the menu next to your help center's name, at the top left of the app (see Understanding & Navigating Multiple Languages)The language menu listing English (Default) and Deutsch
  2. Head to Settings > Languages > Machine translation
  3. Under Your translations, click Add translation
  4. Enter the word you don't want to be translated in the Original word column and leave the Translation column blank
  5. Hit Save changes

Now your chosen word will be excluded from machine translations and it'll be left alone by the bots πŸ€– This is perfect for product and brand names.

Translating Certain Words Into Specific Translations

  1. Pick the language you want to customize from the menu at the top left of the app
    The language menu listing English (Default) and Deutsch
  2. Head to Settings > Languages > Machine translation
  3. Under Your translations, click Add translation
    1. Enter the word you want to translate in the Original word column
    2. Enter the word you want it to be translated into in the Translation column
  4. Hit Save changes

Managing Your Translations

  • Find one: once you have a few, type in Search translations above the list to filter it.
  • Change one: edit either column, then hit Save changes.
  • Remove one: click the β‹― menu at the end of its row, choose Remove, then hit Save changes.

How Your Translations Are Applied

  • Exact matches only. Words are matched exactly as you type them, including capital letters, so add a separate row for each spelling you use.
  • Longest first. Your translations are applied in order of length, longest first, so a phrase like "Brightdesk Pro" is handled before "Brightdesk" on its own.
  • Titles and categories too. They apply to article titles and bodies, and to category titles and descriptions.
  • New translations only. They're used each time something is machine translated, so they don't change translations you already have. Machine translate the article again to pick up a change.
Machine translation customizations are per-language so you can customize the translation in each of your additional languages. Perfect for brands with different brand names in different languages πŸ’–

What did you think of this doc?

Previous Automatically Translate Articles with Machine Translations Next Understanding Machine Translation Credits