Manage domain language settings

In your domain settings, you can set a primary language for each subdomain and domain hosted on HubSpot. This helps search engines identify the language of that domain's content and include that content in the correct group of search results. 

This will also determine the language for system pages using the same domain, such as your email subscription preference page. For example, if you set a domain to Spanish, the email subscription page for that domain will automatically be translated to Spanish.

Before you get started

Before you begin working with this feature, make sure to fully understand what steps should be taken ahead of time, as well as the limitations of the feature and potential consequences of using it. 

Understand requirements

• To manage domain language settings, a user must be a Super Admin or have Website settings permissions.

Understand limitations & considerations

• The language in blog settings will override the primary language chosen in Language settings. Learn more about updating a blog's primary language.

Choose the primary language for a domain

You can set the primary language for a domain during the domain connection process, or after it's been connected. Learn more about setting the primary language while connecting a new domain.

• To set the primary language for a connected domain:
  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, navigate to Content > Domains & URLs.
  3. Click the Language Settings tab.
  4. In the Primary language column, click the Choose primary language dropdown menu next to the domain and select a language.
  5. To include the two-letter abbreviation for a domain's primary language in page URLs, toggle the Use prefix in slug switch on. This will affect the URL of all pages on this domain. 

• When you've finished setting the primary language for the domain, click Save on the bottom left of the page.

Edit the primary language for a domain

You can edit the primary language for an existing connected domain. This ensures the domain's content is correctly identified by search engines for its specified language. 

• To edit the primary language for a domain:
  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, navigate to Content > Domains & URLs.
  3. Click the Language Settings tab.
  4. On the language settings page, hover over the domain and click Edit.
  5. In the dialog box, select the primary language in the New primary language dropdown menu. 
  6. Enter the domain name in the To confirm, enter the domain name field. 
• When you've finished, click Update language. 

Manage language specific redirects

By default, any links on the translated version of a page will redirect to a version of the destination page in the same language. Language-specific redirects do not apply to links in menu modules and will only occur if a translation is available. 

HubSpot does not use geoIP or a browser's set language to determine which variation of a page should render. For example, if the visitor's browser is set to French, your pages will not automatically display in French. Instead, if a visitor is looking at a page in French and clicks a link to another page with a translated French version, they will be routed to that translated page.

• To change this default behavior in domain settings: 
  1. In your HubSpot account, click the settings settings icon in the top navigation bar.
  2. In the left sidebar menu, navigate to Content > Domains & URLs.
  3. Click the Language Settings tab.
  4. Toggle the Enable Language Specific Redirects switch off. With this setting turned off, links will load the version of the page specified in the link, regardless of whether it matches the language of the original page. 
• When you've finished, click Save on the bottom left of the page.

Please note: you can turn off this feature for an HTML element and its children by adding "hs-skip-lang-url-rewrite" as a class for that element. Learn more about applying a custom class to a module group.