Create knowledge base articles in multiple languages
Last updated: February 4, 2021
Applies to:
Service Hub Professional, Enterprise |
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 Website > 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.
- 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.
- 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.
- Select a category with a Needs translation label and in the top right, click Edit.
- Enter the translated Category name and Category description.
- 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.
- 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.
- 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.

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.

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

Related content
-
Set up single sign-on (SSO) to access private content
Single sign-on (SSO) is a way to log into different applications securely with one username and password. ...
Knowledge Base -
Edit your favicon
A favicon is the small image in a browser tab next to the page title, usually based on the website you're...
Knowledge Base -
Add a support form to your knowledge base
Add a support form to your knowledge base. Visitors can submit the form when they can't find their answers in...
Knowledge Base