Skip to content

Connect your domain to HubSpot

Last updated: June 11, 2024

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

All products and plans

Connect your website domain to HubSpot to publish your content on HubSpot-hosted website or landing pages, blog posts, knowledge base articles, and customer portal. 

Before you get started

  • Learn more about the types of content you can publish to your domain based on your subscription.
  • To connect your domain, you will need to update your DNS records. Ensure you have login details for your DNS provider and access to the DNS records. 
  • If you're moving a live website to HubSpot, review the domain verification process if you want to pre-provision SSL for the domain
  • A subdomain can only host pages in a single location. If you connect a subdomain to HubSpot that is currently hosting external pages, links to those external pages will break. To host pages in multiple locations, such as HubSpot and WordPress, use a separate subdomain for each provider. 
  • To connect a subdomain to HubSpot (such as www.hubspot.com), you will need to update CNAME records. To connect a root domain to HubSpot (such as hubspot.com), you will need to update A records. 
  • All IP addresses are in IPv4 format. You can convert them to IPv6 format using an online tool like this one. 

Connect a new domain

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Content > Domains & URLs.
  • Click Connect a domain
  • Select the type of domain you want to connect:
    • Primary: the subdomain will be the default host for the selected content types in HubSpot.
    • Secondary: the subdomain can host HubSpot content, but will not be set as the default for your content (Marketing Hub Professional and Enterprise, Content Hub Professional and Enterprise only). To connect a secondary domain, a primary domain must be connected first. 
    • Redirect: this subdomain can't be used to host content, but will automatically redirect to another domain connected to HubSpot. You can also add individual URL redirects from redirect domains to any HubSpot-hosted page or external page.
    • Email Sending: the subdomain will add another layer of authentication to your HubSpot emails. Learn more about how to connect an email sending domain.
  • If you are connecting a reverse proxy, click to toggle the Connect with HubSpot's built-in content delivery network (CDN) switch off. 
  • Click Connect.

connect-a-domain-without-reverse-proxy

  • Select the checkbox next to each content type you will host on this domain, then click Next.

Please note: the Email content type is used for the web version, image, and subscription preferences page URLs of your marketing emails. This is separate from the email sending domain, which is used to authenticate the From address used to send your marketing emails. Learn how to connect an email sending domain.


2024-05-29_09-37-49
  • Enter your domain, then click Next

enter-root-domain-to-connect

Please note: if you encounter an error that your domain was already added by a HubSpot customer, verify that you are not using the domain in another HubSpot account. If you're unable to access the account using the domain or believe another customer account is using the domain in error, reach out to HubSpot Support.

  • Set up the four components of your domain:
    • Subdomain: the subdomain is the first part of the domain name. For example, in blog.mywebsite.com, blog is the subdomain. Leave this field blank to connect and host content on the root domain.
    • Brand domain: the brand domain, otherwise known as the domain name, is between the subdomain and the top-level domain. For example, in blog.mywebsite.commywebsite is the brand domain. If you are connecting a domain for the first time, this domain will be set as your account's brand domain. Learn more about brand domains.
    • Top-level domain: the top-level domain comes after the brand domain. For example, in blog.mywebsite.com.com is the top-level domain.
    • Primary language: the primary language helps search engines understand the language of your page content for the subdomain. Learn more about managing multi-language content.
enter-domain-to-connect-to-hubspot
  • In the bottom right, click Next.
  • Redirects will be automatically set up either from your root domain to the subdomain you've entered or from the www subdomain to your root domain, depending on whether you're connecting a root domain or subdomain. To edit these default redirects:
    • Click Edit redirect.
confirm-redirects-for-root-domain
    • In the dialog box, enter the domain that will redirect visitors to your connected domain, then click Save

For the next step of the process, you'll need to log in to your DNS provider to access your DNS records. If you don't have access or are unsure how to do this, reach out to your IT team or contact your DNS provider directly.

For detailed instructions on editing your DNS records for the most common DNS providers, check out the DNS setup guide

  • If you use GoDaddy, click Authorize with GoDaddy. You'll then be prompted to log in to your GoDaddy account. This allows HubSpot to access your GoDaddy account and automatically update the CNAME record for the domain.
  • If you use IONOS, click Authorize with IONOS. You'll then be prompted to log in to your IONOS account. This allows HubSpot to access your IONOS account and automatically update the CNAME record for the domain.
  • If you use Google Domains or Cloudflare, click Visit URL in the Action column. You'll then be prompted to sign into your domain provider account. This allows HubSpot to access your domain provider account and automatically update the CNAME record for the domain.
  • If you're using a different domain provider, or if you'd rather make the changes to your DNS configuration manually, click No, I'll set it up manually
  • If you do not currently have access to your DNS provider, you can continue setting up your domain later. In the bottom left, click Finish later. You'll be able to resume connecting your domain to HubSpot at a later time. 
  • Log in to your domain provider and locate your DNS record settings. If you can't find your DNS settings, reference the steps outlined by provider.
  • Copy the values in the Host and Required Data columns in HubSpot. In your DNS provider account, paste the values into the appropriate record fields for the record of the subdomain you're connecting. Once you've entered the values into the record, click Verify.

update-dns-records

Please note: some providers, such as Network Solutions, or GoDaddy, will add your brand domain and top-level domain to the end of DNS records automatically. For example, if you enter {hsdomainkey}.yourdomain.com, it will turn that value to {hsdomainkey}.yourdomain.com.yourdomain.com, which will result in a DNS error. Instead, copy the value but remove the .yourdomain.com part, then paste into the corresponding field in your DNS provider account.

  • Once you update your DNS records, they will be verified within 15 to 80 minutes. You can check on how much time remains at the bottom of the page. Leaving this page will not interfere with the validation process. 

your-records-are-updating-1

  • If there are any problems verifying your DNS changes, you can review a detailed description of any errors that occurred. For a more detailed description of the error, hover over the warning alert icon In the Current data column. 
fix-dns-record-errors

 

Once your domains are connected, SSL will be turned on automatically. This usually takes a few minutes, but can take up to four hours. Learn more about SSL and domain security and troubleshooting SSL certificate errors

HubSpot does not provide SSL certificates for domains that exceed 64 characters. This limit includes the subdomain, domain, and top-level domain. If your domain needs to be longer than 64 characters, you can turn on SSL by purchasing a custom SSL certificate. To set this up, reach out to your HubSpot account representative, or contact HubSpot Support to get connected with the right person.

Add new content types to existing domains

Once you've connected a domain, you can edit which content types are hosted on that domain. 

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Content > Domains & URLs.
  • Next to the domain you want to edit, click the Edit dropdown menu and select Connect domain with more content types.

edit-content-types-for-domain

  • In the dialog box, select the checkbox next to each content type you want to host on this domain, then click Save. If a content type already has a primary domain selected, you will need to edit its primary domain instead. 

set-content-types-for-domain

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