CMS-General

Manage multi-language content in HubSpot

Last updated: November 1, 2018

Applies to:

Marketing Hub
marketing-basic-pro-enterprise
Basic, Professional, Enterprise
HubSpot CMS

In HubSpot, you can easily manage your multi-language content for your global audiences.

Please note: multi-language content is currently only available for landing pages and website pages.

Select the primary language for your domain

Before you create any translated pages, you'll need to set the primary language for each domain set up in HubSpot.

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Domains & URLs.
  • Click the Language Settings tab.
  • Click Choose primary language next to the domain to build your translated pages on.
  • In the dropdown menu, select a language.

  • In the bottom left, click Save.

Please note: if you set your primary language incorrectly, contact HubSpot Support. It can take up to 3 business days to reset the primary language setting.

Create a translated page

  • In your HubSpot Marketing Hub account, navigate to Marketing >WebsiteLanding Pages or Website Pages.
  • Hover over a page and click the More dropdown menu, then select Create Translation.
  • In the dialog box, click the Select language of current page dropdown menu and select the language of the current page, then click the Select a language for your translated clone dropdown menu and select the language for the new translated page you're creating.
  • Click Create.

  • In the page editor, the language abbreviation will be appended as a slug in the Page URL in the Settings tab.
  • You can access the master page and any other translated pages using the language dropdown menu in the upper left.

Please note: none of the actual content on a translated variation of a page will be translated automatically; you will need to do this on your own. If you've specified a language that reads right-to-left (e.g., Arabic or Hebrew), the content editor for your translated page will update to reflect this formatting.
  • A globe language icon will appear next to translated pages on the landing pages or website pages dashboard. Hover over the globe language icon to view a list of translated variations of the page.

  • The page's language will be defined in the HTML head based on the domain's defined language setting (if no language was set, HubSpot will default to defining the domain as English).
<meta http-equiv="content-language" content="fr">
  • 'hreflang' tags will be incorporated into HubSpot-hosted landing pages and website pages.
<link rel="alternate" hreflang="fr">
<link rel="alternate" hreflang="en">
<link rel="alternate" hreflang="de">

To redirect visitors to their language-specific version of the page when available:

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Domains & URLs
  • Click the Language Settings tab.
  • Click to toggle the Enable Language Specific Redirects switch on. If you enable this setting, you'll see the following query parameter appended to your URLs: 
hslang=<lang path>

You can disable this feature for a particular HTML element and its children by adding "hs-skip-lang-url-rewrite" to the class list for that element. Learn more about applying a custom class to a specific module group.

Please note: language-specific redirects do not work for links in advanced menu modules or simple menu modules.

Connect a translated page to a master page

If you have a live master page in your default language, you can connect a translated page to give it the same SEO rankings as the master page.

  • In your HubSpot Marketing Hub account, navigate to Marketing > Website > Landing Pages or Website Pages.
  • Hover over a translated page and click the More dropdown menu, then select Create Translation.
  • In the dialog box, click the Choose a master tab. Click the Select language of current page dropdown menu and select the language of the current page, then click the Select a master page dropdown menu and select the master page to associate the new translated page with.
  • Click Save.

Add a language switcher to your pages

You can add a language switcher to your pages to allow visitors to switch between translated versions of your page.

Please note: the language switcher will only appear on live pages if more than one translated version of the page has been published and connected.

  • Navigate to your page's template.
  • In the inspector, click + Add and use the search bar to search for the Language Switcher module.
  • Click and drag the Language Switcher module into place on your template, then click the module to edit it.
  • Select the display mode for 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 names of the languages 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: a combination of Localized and PagelangFor 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.
  • Click Done.
  • In the upper right, click Publish to update your template.

Please note: while you can create a translated page in any of the languages available in the Select a language for your translated clone dropdown menu and the language name will appear in the switcher, only the following language names will appear translated in that language when rendered in the language switcher:

  • Chinese (China)
  • Chinese (Hong Kong)
  • Czech
  • Danish (Denmark)
  • Dutch (Netherlands)
  • Finnish (Finland)
  • French (France)
  • German (Germany)
  • Greek (Greece)
  • Italian (Italy)
  • Japanese (Japan)
  • Norwegian Nynorsk (Norway)
  • Polish (Poland)
  • Portuguese (Brazil)
  • Spanish (Mexico)
  • Spanish (Spain)
  • Swedish (Sweden)

Was this article helpful?

If you still need help you can get answers from the , or to contact support.