Skip to content
Domains & URLs

Replace your brand domain

Last updated: August 3, 2021

Applies to:

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

If you're rebranding your company or website, you can replace your brand domain to update the URLs of your hosted content.

Before you get started

  • Review the structure of a URL:

url-anatomy-brand-domain

  • 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, when replacing the brand domain hubspot with inbound:
    • www.hubspot.com will become www.inbound.com
    • blog.hubspot.com will become blog.inbound.com
  • If you're only changing the top-level domain, you do not need to replace your brand domain. You can just connect a domain with the new top-level domain using your existing brand domain.
  • Any custom analytics views created using the old brand domain will be deleted from your account after the brand domain is replaced.
  • If you are a Marketing Hub Enterprise or CMS Hub Enterprise user and have the domain limits increase or the business units add-on, you can host and manage content for an additional brand domain per add-on.

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 Website > Domains & URLs.
  • Connect your new domain as a redirect domain. You should also connect any secondary domains for your new brand as redirected domains.
  • Scroll to the bottom of the Domains & URLs settings page and click Advanced options.
  • Click Replace brand domain.

  • 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 redirect 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, 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. Additionally, the domain listed in the New Domain column will not match the new domain you've connected. Swapping the primary domain will correct this and will 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

If you have a Marketing Hub Professional, Enterprise or CMS Hub Professional, Enterprise subscription, you can use your brand domain as a secondary domain for hosting content or replace any secondary domains with your new brand domain.

To swap content on your secondary domains 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 then 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