How to Create Multilingual Knowledge Base Articles in Hubspot

Building a multilingual knowledge base in Hubspot helps your global audience find accurate, localized support content. This guide walks you step by step through creating, translating, and managing articles in multiple languages using the Hubspot knowledge base tool.

All instructions here are based on the official Hubspot documentation for creating knowledge base articles in multiple languages.

Prerequisites for Hubspot multilingual articles

Before you create translated articles, confirm that your Hubspot knowledge base is already set up and that you understand how to create standard articles in your primary language.

You will need:

Access to Service Hub Professional or Enterprise in Hubspot.
Permissions to create and edit knowledge base articles.
A published or draft knowledge base article in your primary language.

If you need help configuring your broader Hubspot setup, you can review implementation services and strategy resources at Consultevo.

Understanding how Hubspot handles knowledge base languages

Hubspot uses a concept called primary language and associated languages to organize multilingual articles. Each article can have language variants that are grouped together in a single language group.

Key concepts:

Primary article: the original article, usually in your main language.
Language variant: a translated version associated with the primary article.
Language group: the full set of related articles (all languages) for one content topic.

Within a language group, Hubspot keeps metadata such as the primary article and the connected variants, while allowing each article to have its own language-specific content and URL.

How to add a new language to your Hubspot knowledge base

Before adding translated articles, make sure the language is available as a knowledge base language in Hubspot.

Navigate to your Hubspot account settings.
Go to your service or website tools where knowledge base settings are managed.
Locate the knowledge base language settings section.
Add the desired language as an associated language so you can use it for articles.

Once a language is enabled, it becomes available in dropdowns when you create language variants for your articles.

Create a translated article from an existing Hubspot article

The simplest workflow is to create a translated variant directly from an existing primary article in Hubspot.

Step-by-step: create a language variant in Hubspot

In your Hubspot account, navigate to Service > Knowledge Base.
In the article list, find the article you want to translate.
Open the article editor for that piece of content.
Locate the Language or Translate controls in the article editor (labels may vary slightly based on your Hubspot interface).
Select the option to add a translated article or create a language variant.
Choose the target language from the dropdown list. Only languages configured as associated languages for your Hubspot knowledge base will appear.
Hubspot will generate a new, connected article for the selected language. This variant is now part of the same language group as the primary article.

The new variant can inherit some settings from the primary article while still letting you customize all content fields to match the target language.

Edit content in your new Hubspot language variant

After creating the variant, edit the translated article as needed:

Update the article title in the target language.
Translate and localize the body content, including images, links, and calls-to-action.
Change the article URL slug to a language-appropriate version.
Edit SEO metadata, such as meta description and page title, in the target language.

You can save the variant as a draft until the translation is complete and reviewed. When ready, publish the article so it appears in your Hubspot knowledge base in the selected language.

Manage language groups in Hubspot

Every time you add a variant, Hubspot groups the original and translated articles into a language group. Managing this group correctly ensures a consistent user experience for visitors switching languages.

View all language variants for an article

Go to Service > Knowledge Base in Hubspot.
In the article listing, look for a language or globe icon that indicates multiple languages.
Click the language indicator or the article settings to see all variants in the group.
From here you can open, edit, or unpublish any specific language variant.

This view helps you verify that each language variant is complete and correctly assigned.

Change the primary article in a Hubspot language group

In some projects, you might start with one primary language and later want to set another variant as primary. Hubspot lets you change which article is considered the primary version for the language group.

To change the primary article:

Open the article group or one of the variants in the editor.
Use the language group or primary article settings within Hubspot to select a different article as primary.
Confirm the change so the new primary article is recognized as the main version.

Changing the primary article affects how Hubspot organizes the group, but all variants remain connected.

Best practices for multilingual knowledge base setup in Hubspot

To keep your multilingual articles organized and consistent, follow these practices derived from Hubspot documentation.

Align article structure across languages

Use similar titles and headings in each language so users can recognize related content.
Maintain comparable article length where possible to keep experiences consistent.
Match internal links across variants so users are directed to the same concepts in their language.

Keep URLs and SEO metadata language-appropriate

Set localized URL slugs in each Hubspot variant to match the article language.
Write meta descriptions and titles in the appropriate language for better search visibility.
Avoid mixing languages in a single article; keep each variant fully localized.

Use Hubspot’s language settings to guide visitors

Configure language options so visitors can switch between language variants from the article interface.
Make sure your knowledge base home page includes clear navigation to each supported language.
Verify that search behavior in the Hubspot knowledge base returns results in the user’s preferred language when available.

Troubleshooting multilingual knowledge base issues in Hubspot

If your translated articles do not appear as expected or seem disconnected, review these checkpoints:

Confirm that the target language is enabled in your Hubspot knowledge base settings.
Verify that you created a language variant of the original article, not a completely separate, standalone article.
Check that each variant is published and not just saved as a draft.
Review the language group to ensure the articles are properly linked under the same topic.

For detailed screenshots and interface labels, consult the official documentation: Hubspot knowledge base multilingual article guide.

Next steps for scaling multilingual support in Hubspot

Once your first multilingual articles are live, repeat the process for other high-traffic or high-value topics in your Hubspot knowledge base.

You can:

Prioritize translations based on ticket volume or customer regions.
Standardize translation workflows with your content or localization team.
Regularly review analytics in Hubspot to see which languages and articles drive the most engagement.

With a clear language strategy and careful use of Hubspot’s knowledge base tools, you can provide a consistent, localized self-service experience for customers around the world.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`

Hupspot multilingual knowledge base guide