Skip to content
English
More support Customer portal Sign in
Website
  • There are no suggestions because the search field is empty.

Create Knowledge Base Articles in Multiple Languages

Learn how to use HubSpot's multi-language support for creating knowledge base articles that serves customers in multiple languages.

HubSpot allows you to create multi-language knowledge base articles and organize them in language groups. This helps visitors easily navigate your translated content.
 
Enable Multi-Language Articles
  1. In your HubSpot account, go to Settings (⚙️) > Content > Knowledge Base.
  2. Click the second dropdown at the top, then select Add/edit multi-language variations.
  3. In the right panel, click Add multi-language variation and select a language. Repeat for additional languages.
  4. (Optional) To delete a language, click the delete (🗑️) icon next to it.
  5. To change the primary language, use the Primary dropdown.
 
Translate Your Knowledge Base Template & Categories
Before translating articles, update your template and categories for a seamless user experience.
 
Translate the Knowledge Base Template
  1. Navigate to Content > Knowledge Base.
  2. Click Customize template (top right).
  3. Click Edit in the Multi-language section.
  4. Click [X] of [X] Filter languages, uncheck languages you don’t want to display, then Apply.
  5. Add translations for each template section.
  6. Click Publish translation, then Update template.
 
Translate Categories
  1. Navigate to Content > Knowledge Base.
  2. Click Organize categories (top right).
  3. Select a language from the filter at the top. Categories needing translation will be labeled Needs translation.
  4. Select a category, then click Edit (top right).
  5. Enter translations for Category name, description, and subcategory name.
  6. Click Publish.
 
Create a Multi-Language Article
  1. Go to Content > Knowledge Base > Articles.
  2. Hover over an article, click More, then select Create multi-language variation.
  3. In the dialog box, choose a Variation language or add a new one via settings. Click Save.
  4. Add the translated content in the editor.
  5. To switch between variations, use the Language dropdown at the top.
Additional options:
  • Edit language: Change the variation’s language.
  • Disconnect variation: Convert a variation into a separate article.
  • Add more variations: Click Create multi-language variation and select another language.
When finished, click Publish to make the translated article live.
 
Add an Existing Article to a Multi-Language Group
If you've already created separate articles for translations, you can merge them into a language group:
  1. Go to Content > Knowledge Base.
  2. Select the checkboxes next to the articles.
  3. Click Add to language group (top of the table).
  4. Select a primary knowledge article from the dropdown.
  5. Click Save.

For additional details, please refer to the HubSpot Knowledge Base article "Create knowledge base articles in multiple languages."