Manage domain language settings

Each domain or subdomain hosted on HubSpot can be assigned a primary language. This setting defines your content’s language for search engines and for system pages. For example, setting a domain to Spanish causes its subscription page to display in 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 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.
• HubSpot doesn't use geoIP data or a browser’s preferred language to choose which translation to display. Visitors always see the version of the page that matches the URL they open.
• Language specific redirects don't apply to links in menu modules and will only occur if a translation is available. 

Choose the primary language for a domain

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

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 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. 
6. When finished, click Save on the bottom left of the page.

Edit the primary language for a domain

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. 

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. Hover over a domain and click Edit.
5. In the dialog box, click the New primary language dropdown menu and select a language. 
6. Enter the domain name and then click Update language. 

Manage language specific redirects

Language specific redirects control how visitors move between translated versions of your pages. When a visitor views a translated page and clicks a link to another page with a translation in the same language, they are directed to that translated version. For example, if a visitor is viewing the French version of a page and selects a link to another page that has a French translation, they will be routed to that translated version.

• 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. When this setting is off, links load the version of the page specified in the link, regardless of whether it matches the language of the page the visitor is viewing.
  5. When 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.