Create knowledge base articles in multiple languages

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 main navigation bar.
• In the left sidebar menu, navigate to Website > 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.

• 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 Service > 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.

• 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 Service > 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.

• 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. 

• 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 Service > 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.

• 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.

• 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 Service > Knowledge Base.
• Click the Articles tab.
• Hover over an article and click Edit.
• At the top of the page, click the Language dropdown menu, then click 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.