Landing Pages
Blog
Design Manager

Manage multi-language content

Last updated: July 15, 2020

Applies to:

Marketing Hub  Professional, Enterprise
CMS Hub  Professional, Enterprise
Legacy Marketing Hub Basic

You can manage content for your global audience in multiple languages on your landing pages and website pages. This article covers how to create a group of pages with content that's translated into multiple languages. 

Learn how to add new translations, link existing translations into a new language group, and manage global content. You'll also need to work with your web developer to add a language switcher module to your page template so visitors can select their preferred language on your site. 

Please note: the content on a multi-language 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. 

In addition to managing multi-language content, HubSpot also offers system-generated content for default content creation languages. Learn more about HubSpot's language offerings.

Before you get started

  • You'll need to work with your web developer or someone on your team who is comfortable making edits in the design manager tool to add a language switcher to your page template.

Create a multi-language page group

You can create a new group with multi-language variations from your landing pages or website pages dashboard. Once you create a multi-language variation of a page, those pages will be part of one multi-language group.

Create a multi-language group

To create a new group of multi-language pages:

  • In your HubSpot account, navigate to your landing pages or website pages.
  • Hover over the page you want to translate into multiple languages. Click the More dropdown menu and select Create multi-language variation.
  • In the dialog box, click the Variation language dropdown menu and select the language you want to translate this page into.
  • Click Save.

Edit your multi-language page content and settings

Next, in the content editor, you'll have a clone of your existing page in the primary language. Here you can translate and localize the content in your new language variation.

  • Within the page editor, edit your page content for the Variation language you've selected.
  • You can switch between multi-language variations by clicking the Language dropdown menu at the top of the page.

manage-multi-language-content

  • The URL of your multi-language variation will include a slug for this page's language in the Page URL in the Settings tab.
  • You can edit the language for this page by clicking the Page language dropdown menu and selecting a new language. Changing the language here in your settings will update the page URL automatically.

multi-language-page-url-slug

View and manage pages in a multi-language group

In your pages dashboard, a language globe icon will appear next to pages that are in an existing multi-language group. Click therightarrow icon to view the other variations of the page in this multi-language group.

translated-pages

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. The best way to add a multi-language variation to global content is from within the page editor.

  • Within the page editor, hover over the global content in your page, which is labeled with a globalGroup global content icon.

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

  • In the dialog box that appears, 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 Manage multi-language variations panel, click the Primary dropdown menu to select the primary language for this global content.
  • Click the Variations dropdown menu to select the language of your multi-language page. You can add more variations here by clicking Add a language variation.
  • Click Save in the lower left.

add-multilanguage-variations

  • To manage language variations for your global content, click the Language dropdown menu at the top of the editor and select Add/edit multi-language variations.

select-language-variation-global-content

  • Within the global content editor, click any module in the left panel to edit its contents.
  • When you've finished making your changes to your global content variation, click Publish to [X] assets in the upper right. The new language variations will be added to all pages and blog posts using this global content. A published language variation will only be displayed on pages or blog posts that contain the same page language.
  • Click Back in the upper left to navigate back to your page or blog post.

Move an existing page into another multi-language group

To add a page into an existing multi-language group, navigate to your landing pages or website pages dashboard.

  • Hover over a page and click the Actions dropdown menu, then select Add to multi-language group.
  • In the dialog box, click the Language of selected page dropdown menu and select a language for this page.
  • Then click the Select a primary page dropdown menu and select a primary page to associate this page with.
  • Click Save.

page-add-to-language-groupNow this page will be added to a multi-language group with the primary page you selected.

Delete a multi-language variation

To delete a page in a multi-language group, you must first remove the page from the multi-language group.

  • In your HubSpot account, navigate to your landing pages or website pages.
  • In the page dashboard, hover over the page you want to delete, then click the Actions dropdown menu and select Remove from multi-language group.
  • In the dialog box, click Remove. You'll now be able to archive or delete this page.

Add a language switcher to your pages

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

  • 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 Pagelang. 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.
  • Click Done.
  • In the upper right, click Publish to update your template.

Additional language considerations

Your domain language in the HTML of your 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 defining the domain as English by default.
<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.

Set the primary language for your domain

You can set the primary language for an entire domain 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.

Please note: for a blog, the language in your blog settings will override the primary language chosen in this setting. Learn how to update your blog's primary language.

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.
  • In the Primary language column click the Choose primary language dropdown and select a language.
  • To automatically append the language prefix for your default language to page URLs in this language, switch the Use Prefix in Slug toggle on. This action would add the two-letter abbreviation for you primary page language to all pages hosted on this domain in your primary language. This step is not required to create multi-language content.

set-primary-language-for-domains

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

/cos-general/how-to-manage-multi-language-content-with-hubspots-cos?__hstc=222209287.530a5e66e49221ce82b8067b25f3e76c.1587543444113.1589874886401.1591876893033.6&__hssc=222209287.6.1591876893033&__hsfp=2476155351