Create knowledge base articles in multiple languages

Create knowledge base articles in multiple languages and organize them into language groups. Language variations give visitors access to help content in their preferred language. 

For related tools, learn more about working with language variations in blogs and pages.

Before you get started

Before you begin managing multi-language variations, review the requirements and considerations.

Understand limitations & considerations

• These tools are only available for migrated knowledge bases. Learn more about migrating your knowledge base.

Add or edit language variations

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the left sidebar menu, navigate to Content > Knowledge Base.
3. At the top of the page, click the second dropdown menu, then click Add/edit multi-language variations. In accounts with the Brands add-on, this will be the third dropdown menu. 

4. In the right panel, click Add multi-language variation, then select a language. Repeat this step for any additional languages.
5. To delete a language, click the delete delete icon next to that language.
6. To change the primary language of your knowledge base, click the Primary dropdown menu, then select a language.
7. When finished, click the X in the top right.

Translate knowledge base categories

Translate categories before creating article language variations so visitors can navigate translated content.

1. In your HubSpot account, navigate to Service > Knowledge Base.
2. In the top right, click the Configure dropdown menu, then select Categories.
3. Click the language filter at the top and select a language. Categories without translations display a Needs translation label.

4. In the sidebar editor, select a category, then click Edit.
5. Enter translated text for the Category name, Category description, and Subcategory name fields for each language. 
6. In the top right, click Update template.

Learn more about organizing and managing your knowledge base categories.

Create a language variation of an article

After adding language variations in settings and translating categories, create language variations for individual articles.

1. In your HubSpot account, navigate to Service > Knowledge Base.
2. Hover over an article, click the Actions dropdown menu, then select Create language variant.

3. In the dialog box, click the Variation language dropdown menu and select a language, or click Create to add a new language.
4. Click Save.
5. In the editor, enter the translated text content. 
6. To switch between variations, click the Language dropdown menu in the top left and select a variation.

Edit the language of an article

1. In your HubSpot account, navigate to Service > Knowledge Base.
2. Click the name of the article.
3. In the editor, click Settings in the top right.
4. In the dialog box, click the Article language dropdown menu, then select a language.
5. Click the X to close the dialog box.
6. When finished, click Publish or Update to take your changes live. Updating the language automatically updates the language slug in the URL.

Add an existing article to a language group

If translated articles already exist as separate articles, add the articles to a language group. 

1. In your HubSpot account, navigate to Service > Knowledge Base.
2. Click the checkboxes to the left of the articles you want to add to your group.
3. At the top of the table, click Add to language group. 
4. In the dialog box, click the Select a primary knowledge article dropdown menu and select an article. 
5. Click Save. 

Remove an article from a language group

1. In your HubSpot account, navigate to Service > Knowledge Base.
2. Hover over an article, click the Actions dropdown menu, then select Remove from language group.
3. In the dialog box, click Remove. The knowledge base article will be removed from the group and will no longer be associated to the primary knowledge base article.