Knowledge Base

Create knowledge base articles in multiple languages (BETA)

Last updated: August 19, 2020

In Beta

You can create and manage a multi-language knowledge base to provide resources in your customers' preferred language.

Please note: the content on a multi-language variation of a knowledge base article will not be translated automatically; you will need to do this. 

Enable multi-language in your knowledge base settings

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to CMS > Knowledge base.
  • In the Language section under Other languages, click Add language
  • In the dialog box, click the Select a language dropdown menu and select a language. Learn more about HubSpot's supported languages.
  • Click Add.

add-language-KB

  • On the settings page, click Save.
  • To delete a language, click Remove.

Translate your knowledge base template and categories

Before creating a multi-language variation of a knowledge base article your knowledge base template and categories need to be translated.

Translate your template

  • In your HubSpot account, navigate to Service > Knowledge Base.
  • In the upper right, click Customize template.
  • In the left panel under Multi-language, click Edit.
  • Customize your knowledge base template.
  • In the top left, click the filter link to filter languages displayed on the screen. Clear the checkbox next to the language you do not want to display. Click Apply.

filter-knowledge-base-languages

  • When you are done customizing your template, in the top right, click Publish translation.
  • In the top right, click Update template.

Translate your categories

  • In your HubSpot account, navigate to Service > Knowledge Base.
  • In the upper right, click Organize categories.
  • At the top, click the language filter and select the language to create translations for. A Needs translation label will display on the categories that require translation.

categories-language-filter

  • Select a category with a Needs translation label and in the top right, click Edit.
  • Enter the translated Category name and Category description.

translate-knowledge-base-categories

  • In the top right, click Publish.

Learn more about organizing and managing your categories.

Create a multi-language variation of a knowledge base article

When the knowledge base settings, template and categories have been set up and translated you can create multi-language variations of your existing articles:

  • In your HubSpot account, navigate to Service > Knowledge Base.
  • Navigate to the Articles tab.
  • Hover over the article you want to translate, then click the More dropdown menu and select Create multi-language variation.

create-multi-language-variant-kb

  • In the dialog box, select a language from the Variation language dropdown menu or click Add a language in settings to add a new language.
  • Click Save.

Next, in the editor, you'll have a clone of your existing primary page. Here you can translate and localize the content in your new language variation.

  • Within the editor, edit your article content for the variation language you've selected.
  • You can switch between multi-language variations by clicking the Language dropdown menu at the top of the page.

knowledge-base-language-variations

  • The URL of your multi-language variation will include a slug for this page's language in the Article URL field in the Settings tab.
  • You can edit the language for this page by clicking the Article language dropdown menu and selecting a new language. Changing the language here in your settings will update the page URL automatically.
knowledge-base-url

Connect an existing article to a primary article

If you've created separate articles for translations, you can group the articles under a primary article to create a primary and variation relationship between your articles. 

To add an existing article to a group:

  • In your HubSpot account, navigate to Service > Knowledge Base.
  • Navigate to the Articles tab.
  • Hover over the article and click Edit.
  • At the top of the page, navigate to the language switcher and click Connect to primary article.
connect-to-primary-article
  • In the dialog box, use the dropdown menu to select the language of your article. To set the primary article the translated article will be grouped with, search for and select the primary article in the Select a primary article dropdown menu. Click Apply.
connect-to-primary-article-1Learn more about managing multi-language content.
/knowledge-base/create-knowledge-base-articles-in-multiple-languages