Skip to content

Create knowledge base articles in multiple languages

Last updated: May 24, 2024

Available with any of the following subscriptions, except where noted:

Service Hub   Professional , Enterprise

In HubSpot, you can create knowledge base articles in multiple languages and organize them in multi-language groups. Learn more about working with multi-language content in blogs and pages

Please note: the content on a multi-language variation of a knowledge base article will not be translated automatically. You will need to manually translate it. 

Turn on multi-language articles in your knowledge base settings

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Content > Knowledge Base.
  • In the Language section, scroll down to Other languages and click + Add language.
  • In the dialog box, click the Language dropdown menu and select a language, then click Add. Learn more about HubSpot's supported languages.

add-language-KB

  • In the bottom left, click Save.
  • To delete an existing language, click Remove next to the name of the language.

Translate your knowledge base template and categories

Before creating a multi-language variation of a knowledge base article, it's recommended to translate your knowledge base template and categories. This will help visitors navigate your translated knowledge base.

Translate your template

  • In your HubSpot account, navigate to Content > Knowledge Base.
  • In the upper right, click Customize template.
  • In the content editor, click Edit in the Multi-language section of the sidebar editor.
  • In the top left, click [X] of [X] next to Filter languages. Clear the checkbox next to any language you do not want to display, then click Apply.

filter-knowledge-base-languages

  • Customize your knowledge base template. You will be able to add a translation to each section of the template for each of your knowledge base's languages. 
  • When you are done adding your translations, click Publish translation in the top right.
  • In the top right, click Update template.

Translate your categories

  • In your HubSpot account, navigate to Content > Knowledge Base.
  • In the top right, click Organize categories.
  • At the top, click the language filter and select a language. A Needs translation label will appear on any category that does not currently have a translation in that language.

categories-language-filter

  • In the left sidebar editor, select a category, then click Edit in the top right.
  • Enter a Category name, Category description, and Subcategory name (if applicable) for each language. 

translate-knowledge-base-categories

  • In the top right, click Publish.

Learn more about organizing and managing your knowledge base 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 Content > Knowledge Base.
  • In the top left, click the Articles tab.
  • Hover over an article, then click the More dropdown menu and select Create multi-language variation.

create-multi-language-variant-kb

  • In the dialog box, click the Variation language dropdown menu and select a language, or click Add a language in settings to add a new language. Then click Save.
  • In the article editor, add translated content for the language you've selected to the new blank variation. 
  • To switch between multi-language variations, click the Language dropdown menu at the top of the page and select a variation.

knowledge-base-language-variations

  • To edit the language for this page:
    • Click the Language dropdown menu, then click Edit language.
    • In the dialog box, click the Change language to dropdown menu and select a language.
    • Click Save changes. This will automatically update the language slug in the URL. 
  • To change a language variation into a separate article:
    • Click the Language dropdown menu, then click Disconnect variation from primary.
    • In the dialog box, click Disconnect.
  • To create a variation in an additional language: 
    • Click the Language dropdown menu, then click Create multi-language variation.
    • Click the Variation language dropdown menu and select a language. Only languages that have already been added in your knowledge base settings will appear. To add a new language, click Add language in settings
  • When your translation is complete, click Publish in the top right to take the translated article live. 

Add an existing article to a multi-language group

If you've already created separate articles for translations, you can add the articles to a multi-language group. 

  • In your HubSpot account, navigate to Content > Knowledge Base.
  • Click the Articles tab.
  • Click on the name of your article. 
  • At the top of the page, click the Language dropdown menu, then click Connect to primary article.
connect-to-primary-article
  • In the dialog box, select a primary article to connect:
    • Click the Select a primary article dropdown menu, enter the article name, then select the article.
    • To only see articles in a specific language, click the Filter articles by dropdown menu and select a language.
    • When you've selected a primary article, click Apply

connect-knowledge-base-article-to-primary-article

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.