Skip to content

Create pages in multiple languages

Last updated: May 2, 2023

Available with any of the following subscriptions, except where noted:

All products and plans

You can translate content on a HubSpot page into multiple languages. By adding a language switcher module to the page's template, you can allow your visitors to select their preferred language. 

Custom multi-language content will not be translated automatically. If you specify a language that reads right-to-left (e.g., Arabic or Hebrew), however, the content editor will use this formatting. 

This article covers how to work with multi-language website pages or landing pages. Learn more about creating a multi-language blog or multi-language knowledge base, or setting the primary language for a domain.

Please note:
  • In accounts with a CMS Hub Starter subscription or those using HubSpot's free tools:
    • You cannot create multi-language landing pages.
    • Multi-language blog posts or website pages are limited to 3 language variations per post or page. 
  • System pages, such as 404 error pages, can't currently be created in multiple language variations. 

Create a multi-language variation of a page

  • Navigate to your content:

    • Website Pages: In your HubSpot account, navigate to Marketing > Website > Website Pages.
    • Landing Pages: In your HubSpot account, navigate to Marketing > Landing Pages.
  • Hover over a page, then click the More dropdown menu and select Create multi-language variation.
  • In the dialog box, click the Variation language dropdown menu and select a language.
  • Click Create. This will create a clone of your existing page in the selected language. 
  • In the content editor, create page content in your selected language. To switch between multi-language variations, click the Language dropdown menu at the top of the page and select a variation.

manage-multi-language-content

  • Navigate to the Settings tab. 
  • To edit the language for a variation, click the Page language dropdown and select a language. This will automatically update the language slug in the Language field of the page URL. 

multi-language-page-url-slug

Manage pages in a multi-language group

The multi-language variations for a page combine to form a multi-language group. You can edit a multi-language variation or group from your pages dashboard. 

  • Navigate to your content:

    • Website Pages: In your HubSpot account, navigate to Marketing > Website > Website Pages.
    • Landing Pages: In your HubSpot account, navigate to Marketing > Landing Pages.
  • Hover over a page with multi-language variations. This is indicated by the language globe icon.
  • Click therightarrow icon to view all multi-language variations of the page. 

expand-muti-language-group

  • To delete a multi-language variation: 
    • Hover over the variation and click the More dropdown menu, then select Remove from multi-language group.
    • In the dialog box, click Remove. This will make the multi-language variation its own page. 
    • Hover over the page and click the More dropdown menu, then select Delete
    • In the dialog box, type delete, then click Delete
  • To add a page to an existing multi-language group: 
    • Hover over the page and click the More dropdown menu, then select Add to multi-language group. If your page is already part of a group, select Remove from multi-language group, then restart these steps. 
    • In the dialog box, click the Select a primary page dropdown menu and select the primary page in your existing group. 
    • Click Save
  • To switch which multi-language variation is the primary page in the group: 
    • Hover over the page and click the More dropdown menu, then select Make this the primary page of your multi-language group.
    • In the dialog box, click Continue

Edit global content in a multi-language page

If your page contains global content, you'll need to create separate language variations for your global content from the content editor. The new language variations will be added to all pages and blog posts using this global content. A published language variation will only appear on pages or blog posts that contain the same page language.

  • Navigate to your content:

    • Website Pages: In your HubSpot account, navigate to Marketing > Website > Website Pages.
    • Landing Pages: In your HubSpot account, navigate to Marketing > Landing Pages.
  • Hover over your page and click Edit.
  • In the content editor, hover over the global content. It will be labeled with a globalGroup global content icon.

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

  • In the dialog box, click Open in global content editor.
  • At the top of the global content editor, click the Language dropdown menu and select Add/edit multi-language variations to create a language group.

edit-multilanguage-global-content

  • In the right panel, click the Primary dropdown menu and select the primary language for this global content. This is the language variation that will display if global content does not exist for a page's language. 
  • Click the Add a language variation dropdown menu and select the language of your multi-language page.
  • To add a variation for another language, click the Add language variation dropdown menu and select a new language
  • Click Save in the lower left.

manage-multi-language-variations

  • In the global content editor, click the Language dropdown at the top of the page and select a variation to edit. Learn more about editing global content
  • When you've edited your global content variation, click Publish to [X] assets in the upper right. This will publish your changes to all pages in the specified language using your global content. 
  • 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

To add a language switcher to a page that supports drag and drop editing: 

  • Navigate to your content:

    • Website Pages: In your HubSpot account, navigate to Marketing > Website > Website Pages.
    • Landing Pages: In your HubSpot account, navigate to Marketing > Landing Pages.
  • Hover over a page and click Edit
  • In the content editor, enter language switcher in the search bar of the sidebar editor. 
  • Click the Language Switcher module and drag it onto the page. 
  • In the sidebar editor, 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.
  • In the upper right, click Publish or Update to take your changes live.

Analyze page performance in multiple languages

You can analyze the performance of all languages of a page at once, or separate out performance by language. 

  • Navigate to your content:

    • Website Pages: In your HubSpot account, navigate to Marketing > Website > Website Pages.
    • Landing Pages: In your HubSpot account, navigate to Marketing > Landing Pages.
  • Click the name of the page
  • On the content details page, click the Language dropdown at the top of the page and select an option
    • Select All languages to see the combined analytics for all language variations of this page. The number of language variations this page has will display next to this option. 
    • Select a language to only see the analytics for that language variation of this page. 

select-language-for-analytics

 

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.