Domains & URLs

Replace your brand domain

Last updated: April 13, 2020

Applies to:

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

With the brand domain add-on, Marketing Hub Enterprise users can host and manage content for two or more distinct brands.

The brand domain is the part of a domain between the subdomain and the top-level domain. For example, if your website is www.website.com, website is the brand domain.

url-anatomy-brand-domain

If you're rebranding your company or website, you can replace your brand domain to update your hosted content. When you replace a brand domain, the brand domain for all connected subdomains will be updated. The rest of the URL structure will remain the same. For example, you have the brand domain "hubspot" set up in your account, and you've connected the www.hubspot.com and blog.hubspot.com subdomains. If you replace the brand domain "hubspot" with "inbound":

  • www.hubspot.com will become www.inbound.com
  • blog.hubspot.com will become blog.inbound.com

In the above example, the subdomains and top-level domain stay the same, but the brand domain changes. If this is the outcome you're looking for, you'll only need to follow the instructions in the Replace your brand domain section below.

However, if you're replacing your brand domain and subdomain or top-level domain (www.hubspot.com to info.inbound.com or www.inbound.net), then follow the full instructions below.

If you're only changing the top-level domain, you do not need to replace your brand domain. For example, you can use the hubspot brand domain to host both www.hubspot.com and www.hubspot.net. You would just need to connect a new domain with the .net top-level domain using your existing hubspot brand domain.

Please note: any custom analytics views created using the old brand domain will be deleted from your account after the brand domain is replaced.

Replace your brand domain

Follow the below steps to replace your brand domain. If you're also changing your subdomain or top-level domain, follow the additional steps at the end of this section to replace your primary domain.

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Domains & URLs.
  • Connect your new domain as a redirect domain. You should also connect any secondary domains for your new brand as redirected domains.
  • After the domain is connected as a redirect domain, at the bottom of the Domains & URLs settings page click Advanced options.
  • Click Replace brand domain. domain-manager-replace-brand-domains
  • On the next screen, click the Brand domain to be replaced dropdown menu and select the old brand domain.
  • Click the New brand domain dropdown menu and select the new brand domain.

Please note: if you haven't connected the new brand domain as a redirecting domain, you will not see it listed in the dropdown menu.

domain-manager-choose-new-brand-domain

  • Click Next.

If you're only replacing your brand domain, not the subdomains and top-level domains:

  • On the next screen, click Connect domain next to any subdomains that aren't connected yet.
  • Click Replace brand domain.
  • Your brand domain will now be replaced and your existing content will move to the new brand domain's connected subdomains. This is the final step in the brand domain replacement process.

If you're replacing your brand domain and subdomain or top-level domain, continue reading below.

Additional steps for a new subdomain or top-level domain

If you're replacing your brand domain and the subdomain or top-level domain of your website, continue the process below.

Please note: this process involves replacing the brand domain, and then replacing the primary domain. Between these steps, there will be a brief period of website downtime.

  • On the Verify the new domains screen, an error will appear saying that your domains aren't connected. You'll also see that the domain listed in the New Domain column doesn't match the new domain you've connected. This is expected; when you replace a brand domain, the top-level domain and subdomain will always stay the same. Swapping the primary domain will correct this and update the URL to include your new subdomain and/or top-level domain.

    replace-brand-domain-verify
  • Select the I understand the impact of changing the brand domain checkbox.
  • In the bottom right, click Replace brand domain. You'll be directed back to the Domains and URLs screen.
  • In the Primary domains section of the Domains and URLs screen, click Edit next to the new domain that you've set up, then select Replace primary domain.

    replace-primary-domain-2
  • In the dialog box, click the dropdown menu, then select the new domain that you're replacing your old domain with.
  • Click Replace primary domain.

After replacing the primary domain, your brand domain will be fully swapped and the content on your old primary domain will be accessible on the new primary domain.

If you're also replacing secondary domains, continue to the next section which will guide you through the process of swapping content on secondary domains.

Swap content on secondary domains

With your primary domain replaced, you can now replace any secondary domains with your new brand. For example, you previously had a secondary domain for your landing pages at info.mycompanywebsite.org. To move your existing landing pages from that domain to your new domain of info.newbrand.website, you'll need to update info.newbrand.website from a redirected domain to a secondary domain, then manually update the URLs for your landing pages.

After replacing your brand domain:

  • In the Redirected domains section, click Edit next to the new domain. Then select Make this a secondary domain.

    domain-manager-make-secondary-domain
  • In the dialog box, select the content type for the domain. Click Save.
  • The subdomain will appear in the Secondary domains section. You can now manually move your content to the new domain:
  • With your content replaced, you can now either set your old domain to redirect to the new domain, or disconnect it from your account.
    • In the Redirected domains section, locate your old domain and click Edit
    • To redirect the domain to your new brand domain, click the dropdown menu and select the new domain.
    • To disconnect the domain from your account, click Disconnect.

redirect-or-disconnect-domain

 

/cms-general/replace-your-brand-domain