Create pages in multiple languages

Translate content on a HubSpot page into multiple languages by adding a language switcher module to the page's template. This gives your visitors the choice to select their preferred language.

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

• Create blogs in multiple languages

• Create knowledge base articles in multiple languages

• Manage domain language settings

• HubSpot language offerings

Before you get started

Before you begin working with multi-language content for pages, review the requirements, limitations, and considerations.

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.

• System pages (e.g., 404 error pages) don't support multiple language variations.

Create multi-language pages

Create language variations of pages to publish localized content. Each variation shares the same page structure and URL pattern, with a language-specific slug.

Page content can be translated manually or automatically using Breeze.

1. Navigate to your content:
   • Website Pages: In your HubSpot account, navigate to Content > Website Pages.
   • Landing Pages: In your HubSpot account, navigate to Content > Landing Pages.
2. Hover over a page, 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 page 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.

Manage pages in a multi-language group

The multi-language variations for a page combine to form a multi-language group. Manage multi-language variations or groups from your pages dashboard.

1. Navigate to your content:
   • Website Pages: In your HubSpot account, navigate to Content > Website Pages.
   • Landing Pages: In your HubSpot account, navigate to Content > Landing Pages.
2. Hover over a page with the language language icon and click the right arrow icon to expand the group. Then, review the multi-language variations of the page.

3. To delete a multi-language variation, hover over the page, click the Actions dropdown menu, and select Delete. In the dialog box, enter the text 'delete', and then click Delete.
4. To add a page to an existing multi-language group, hover over the page, click the Actions dropdown menu, and select Add to language group.
   • In the dialog box, click the Select a primary page dropdown menu and select the primary page in your existing group.
   • Click Save.

Please note: if your page is already part of a language group, select Remove from multi-language group and then restart these steps.

5. To change which multi-language variation is the primary page in the group, hover over the page, click the Actions dropdown menu, and select Convert to language group primary. In the dialog box, click Continue. 

Edit global content in multi-language pages

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

1. Navigate to your content:

   • Website Pages: In your HubSpot account, navigate to Content > Website Pages.
   • Landing Pages: In your HubSpot account, navigate to Content > Landing Pages.
2. Click the name of your page. 

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

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

6. 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 pages language.
7. To add a variation for another language, click the Add language variation dropdown menu and select a language.
8. When finished adding variations, click Save to go back to the global content editor.
9. In the global content editor, click the Multi-language variation dropdown menu and select a variation to edit. Learn more about editing global content.
10. 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 in the specified language using this global content.
11. In the dialog box, click Publish and return to page editor.

Add a language switcher to a page

A language switcher module allows visitors to switch between translated versions of a page. This module will only appear on a page if multiple pages in its multi-language group have been published. 

Learn more about adding a language switcher module to a coded template in our developer documentation. 

1. Navigate to your content:

   • Website Pages: In your HubSpot account, navigate to Content > Website Pages.
   • Landing Pages: In your HubSpot account, navigate to Content > Landing Pages.
2. Click the name of your page. 
3. In the left sidebar, click the add Add icon. 
4. Click to expand the Functionality section, then click the Language Switcher module and drag it into position.
5. Click the Display mode dropdown menu and select an option for how languages will be displayed on your language switcher:
   • Localized: the name of each language will appear in that language. For example, if you're viewing the English version of a page with a French translation, you'll see English and Français as the language names in the language switcher.
   • Pagelang: the name of each language will appear in the language of the current page. For example, if you're viewing the English version of a page with a French translation, you'll see English and French as the language names in the language switcher.
   • Hybrid: the name of each language will appear in the language of the current page, as well as in that language. For example, if you're viewing the English version of a page with a French translation, you'll see English and French (Français) as the language names in the language switcher.
6. To change the language switcher's icon, click the Icon options dropdown menu and select an option. 

7. To take your changes live, click Publish or Update in the top right.

Analyze page performance in multiple languages

Analyze the performance of all languages of pages at once, or separate performance by language.

1. Navigate to your content:

   • Website Pages: In your HubSpot account, navigate to Content > Website Pages.
   • Landing Pages: In your HubSpot account, navigate to Content > Landing Pages.
2. Hover over a page 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 page. The number of language variations this page has will display next to this option.
   • Language: view the analytics for that language variation of this page.