Landing Pages

Manage multi-language content

Last updated: October 28, 2019

Applies to:

Marketing Hub  Professional, Enterprise
Legacy Marketing Hub Basic
HubSpot CMS

In HubSpot, you can manage your multi-language content for your global audiences on your landing pages and website pages. Learn how to set a primary language for your content, add new translations, and link the translations with a language switcher module so visitors can select their preferred language on your site.

Please note: the content on a translated variation of a page will not be translated automatically; you will need to do this. 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.

Select the primary language for your domain

Before you create any translated pages, you'll need to set the primary language for each domain you've connected in HubSpot. You can set the primary language of a subdomain either while connecting it to HubSpot, or after it's been already connected. Learn more about setting the primary language while connecting a new subdomain. Once the primary language is set, any pages created for that domain will append the language abbreviation in the URL.

To set the primary language for domains that have already been connected:

  • 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.
  • Next to the domain you want to choose a primary language for, click Choose primary language and select a language.

  • In the bottom left, click Save.

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

Create a translated page

  • In the dialog box, click the Select language of current page dropdown menu and select the language of the current page. 
  • Click the Select a language for your translated clone dropdown menu and select the language for the new translated page you're creating.
  • Click Save.

page-create-language-variation-settings

  • 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.

  • A globe language icon will appear next to translated pages on the landing pages or website pages dashboard. Click therighticon to view translated variations of the page.

translated-pages

Additional language considerations

  • 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">

By default, HubSpot changes the links in a language-specific page so that they lead to pages of the same language (e.g., in a Japanese page, a link to "www.domain.com/page1" will automatically be changed to a link to "www.domain.com/jp/page1"). This is not a redirect, but a hard change in the URL of the link. If you want to redirect visitors to their language-specific version of the page when available (e.g., for possible SEO reasons):

  • 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>

This will redirect any links on a language-specific version of a page to the appropriate link with the same translation. 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 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 master page dropdown menu and select the master page to associate the new translated page with.
  • Click Save.

page-add-to-language-group

Add a language switcher to your pages

Adding a language switcher module to your page template allows 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.

  • In your HubSpot account, 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)
  • Korean (Korea)
  • Korean (South Korea)
  • Norwegian Nynorsk (Norway)
  • Polish (Poland)
  • Portuguese (Brazil)
  • Spanish (Mexico)
  • Spanish (Spain)
  • Swedish (Sweden)