Create blogs in multiple languages

Translate HubSpot blog content into multiple languages, including blog posts, authors, and tags. Multi-language blogs help manage localized content while keeping related posts grouped together.

This article explains how to create and manage multi-language blogs and content. To learn more about related features, review the following resources:

• Create pages in multiple languages
• Create knowledge base articles in multiple languages
• Manage domain language settings
• Work with the language switcher module

Before you get started

Before working with multi-language blogs, review the following requirements and considerations.

Understand requirements

• A domain must have a primary language set.
• Each blog in a multi-language group must be assigned a unique language.

Understand limitations & considerations

• HubSpot free tools support up to three language variations for each asset.
• Marketing Hub or Content Hub Starter subscription support up to 50 language variations.
• Marketing Hub and Content Hub Professional or Enterprise have no limit on language variations.
• Blog content isn’t translated automatically. When a right-to-left language (e.g., Arabic or Hebrew) is selected, the content editor applies right-to-left formatting automatically.
• Multi-language variations inherit settings from the primary blog unless overridden.

Manage multi-language blog variations

Add new languages, change a blog's primary language, or remove existing blog 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 > Blog.
3. In the Current View section, click the first dropdown menu and select a blog. In accounts with the Brands add-on, this will be the second dropdown menu. 
4. Click the second dropdown menu and click Add/edit multi-language variations. You may need to set your domain's primary language first. In accounts with the Brands add-on, this will be the third dropdown menu. 

5. To add a multi-language variation, click + Add a language variation in the right panel and select a language. 
6. To change the blog's primary language, click the Primary language dropdown menu and select a language. 
7. To delete a multi-language variation, click the delete delete icon next to that variation. 
8. When finished, click Save. 

By default, multi-language variations use the same blog settings as the primary blog of the group. Once a multi-language variation is selected in the Current view section, you can edit its blog settings by clicking Override primary blog settings for each applicable section. 

Manage multi-language groups

Add or remove blogs from multi-language groups in blog settings. Each blog in a multi-language group must be assigned to a different language. 

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the left sidebar menu, navigate to Content > Blog.
3. In the Current View section, click the first dropdown menu and select a blog. In accounts with the Brands add-on, this will be the second dropdown menu. 
4. Click the second dropdown menu and select a language. In accounts with the Brands add-on, this will be the third dropdown menu. 

Add a blog to a multi-language group

1. In the top right, click the Options dropdown menu and select Add to multi-language group.
2. In the dialog box, click the Select primary blog dropdown menu and select a blog. This blog will be the primary blog of its multi-language group. This can be changed in your blog settings at any time. 
3. Click Continue. 

Set a blog as primary for a multi-language group

1. In the top right, click the Options dropdown menu and select Make primary blog of multi-language group.
2. In the dialog box, click Continue. 

Remove a blog from a multi-language group

1. In the top right, click the Options dropdown menu and select Remove from multi-language group. To remove the group's primary blog, you must set a different blog as the primary blog first. 
2. In the Blog name field, enter a name for the blog. The blog will be removed from its multi-language group and added as a separate blog with this name. 
3. Type remove to confirm you want to remove this blog from its multi-language group, then click Remove. 

Create multi-language blog content

After creating multi-language blogs, create blog posts, authors, tags, and global content in multiple languages.

Create multi-language blog posts

Create language variations of blog posts to publish localized content under a single blog. Each variation shares the same post structure and URL pattern, with a language-specific slug.

Blog post content can be translated manually or automatically using Breeze. 

1. In your HubSpot account, navigate to Content > Blog.
2. Hover over a blog post, then click the Actions dropdown menu and select Create language variant.
3. In the dialog box, click the Variation language dropdown menu and select a language.
4. To automatically translate using Breeze, select the Translate using Breeze checkbox. Learn more about automatically translating content with Breeze.
5. Click Create. 
6. In the content editor, translate the content of your blog post into the target language. To switch language variations, click the Multi-language variation dropdown menu and select a variant in the top left.
7. When finished, click Publish in the top right. 

Create multi-language global content

For blogs that use global content, you can create language variations in the global content editor. Published variations appear only on pages or posts that match the same language.

1. In your HubSpot account, navigate to Content > Blog.
2. Click the name of a blog post. 

3. In the content editor, hover over the global content. Global content is labeled with a globalGroup global content icon.

4. Click the edit edit icon to access the global content editing options.

5. In the dialog box, click Open in global content editor.
6. In the top left, click the Multi-language variation dropdown menu and select Add/edit multi-language variations to create a language group.

7. In the right panel, click the Primary dropdown menu and select the primary language for the global content. This is the language variation that'll display if global content doesn't exist for a post's language. 
8. To add a variation for another language, click the Add language variation dropdown menu and select a language. 
9. When finished adding variations, click Save to go back to the global content editor.
10. In the global content editor, click the Multi-language variation dropdown menu and select a variation to edit. Learn more about editing global content. 
11. When you've finished editing the global content variation, click Publish to [X] assets in the top right. This will publish your changes to all pages and posts in the specified language using this global content. 
12. In the dialog box, click Publish and return to blog post editor. 

Create blog author profiles in multiple languages

Create and translate blog author profiles for each language used in a blog. Learn more about managing blog authors.

1. In your HubSpot account, navigate to Content > Blog.
2. In the top right, click the Configure dropdown menu and select Authors.
3. Hover over an author and click the More dropdown menu, then select Create multi-language variation. 
4. If you haven't set a language for this author, a dialog box will appear. Click the Language dropdown menu and select a language for this author, then click Continue. 
5. In the right panel, click the Language dropdown menu and select the language you'll be using for the translated author profile. 
6. Fill out the author information fields, then click Create author. 

Create blog tags in multiple languages

Create and translate blog tags in multiple languages for a blog. Learn more about managing blog tags. 

1. In your HubSpot account, navigate to Content > Blog.
2. In the top left, click the Configure dropdown menu and select Tags. 
3. Hover over a tag and click the More dropdown menu, then select Create multi-language variation. 
4. If you haven't set a language for this tag, a dialog box will appear. Click the Language dropdown menu and select a language, then click Continue. 
5. In the dialog box, enter a tag name in the Tag name field. 
6. Click the Language dropdown menu and select a language. 
7. Click Create. 

Analyze blog performance in multiple languages

Analyze the performance of all languages of your blog posts at once, or separate performance by language. 

1. In your HubSpot account, navigate to Content > Blog.
2. Hover over a blog post and click Performance.
3. On the content details page, click the Language dropdown at the top of the page and select an option: 
   • All languages: view the combined analytics for all language variations of this blog post. The number of language variations this blog post has will display next to this option. 
   • Language: view the analytics for that language variation of this blog post.