Skip to content

Edit a domain’s language settings

Last updated: June 28, 2023

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

All products and plans

In your domain settings, you can set a primary language for each subdomain and domain hosted in 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.

Set the primary language for your 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.

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 a connected domain:

  • In your HubSpot account, click the settings settings icon in the main navigation bar.
  • In the left sidebar menu, navigate to Website > Domains & URLs.
  • Click the Language Settings tab.
  • In the Primary language column, click the Choose primary language dropdown menu next to your domain and select a language.
  • To include the two-letter abbreviation for your domain's primary language in page URLs, click to toggle the Use Prefix in Slug switch on. This will affect the URL of all pages on this domain. 

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.

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 an appropriate 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 user's browser is set to french, this does not mean that your pages will automatically display in french. However, if a visitor is looking at a page in french, then clicks on a link to another page that has a translated french version, the visitor will be routed to the translated page. 

You can change this default behavior in domain settings: 

  • In your HubSpot account, click the settings settings icon in the main navigation bar.
  • In the left sidebar menu, navigate to Website > Domains & URLs.
  • Click the Language Settings tab.
  • Click to 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. 

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.

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