Domains & URLs

Connect your domain to HubSpot

Last updated: July 15, 2020

Applies to:

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

Connect your domain to HubSpot so that your HubSpot content can be accessed on the web. After connecting a domain, you can publish HubSpot pages, blog posts, knowledge base articles, and web versions of emails to it.

For information on how to connect a domain to improve deliverability of your marketing emails, see our email domain connection guide.

Please note: a CMS Hub subscription is required to connect a www subdomain.

Before you get started

  • Review the structure of URLs:url-anatomy
  • Ensure you have access to the CNAME records in your DNS provider.
  • If you're moving an existing live website to HubSpot, review the domain verification process if you want to pre-provision SSL for the domain
  • If you're keeping part of your website outside of HubSpot, do not connect that subdomain to HubSpot. For example, if your main website is hosted on WordPress at info.mywebsite.com, you should not connect your info subdomain to HubSpot. Doing so will take down your external content.

Please note: if you're hosting your full website with HubSpot, you will need to set up a redirect from the root domain of your website to the www subdomain in your DNS provider. If your DNS provider does not allow 301 redirects, reach out to HubSpot support for further assistance.

Connect your domain

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Domains & URLs.
  • Click Connect a domain.
  • Select the type of domain you want to connect:
    • Primary: the subdomain will be the default content host for the selected content types in HubSpot.
    • Secondary: the subdomain can host HubSpot content, but isn't set as primary for any of your content types (Marketing Hub Professional and Enterprise, CMS Hub Professional and Enterprise only).
    • Redirect: this subdomain won't host any content, but automatically redirects to another domain connected in HubSpot.
    • Email Sending: the subdomain will add another layer of authentication to your HubSpot emails. Learn more about how to connect an email sending domain.
  • Click Connect.
connect-primary-domain

1. Content type

  • Select the checkboxes next to the content types you plan to host on this domain.

    Please note: the Email content type is for the web version of your marketing emails. Marketing emails will use the domain connected as this type for the web version URL and image URLs. 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.

    connect-domain-choose-content
  • Click Next.

2. Select domain

  • In the text field, enter your domain. This is not the subdomain, but the root domain itself.domain-manager-enter-domain-name
  • Click Next.

3. Verify URLs

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.

Please note: only connect subdomains that will be used to host HubSpot content. Connecting a subdomain that's used for hosting non-HubSpot website pages will cause those pages to break.

  • Brand domain: the brand domain is between the subdomain and the top-level domain, otherwise known as a domain name. 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 is the end of the domain that 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.

domain-connect-verify-urls
  • Click Next.

4. Hosting setup

Set up your hosting with your DNS provider. For this 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 our DNS setup guide

  • If you use GoDaddy, click Update my CNAME. 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 are connecting your entire website to HubSpot, you'll still need to make some manual changes to your DNS records.
godaddy-set-up-hosting
  • If you're not using GoDaddy, or if you'd rather make the changes to your DNS configuration manually, click No, I'll set it up manually
    • Confirm that your content is ready to go live, then select the I am ready checkbox. If the domain is currently hosted elsewhere and has SSL, you'll see a message asking you to confirm that you own the domain. This will pre-provision SSL for the domain within HubSpot and reduce website downtime. Learn more about pre-provisioning SSL.
    • Log in to your DNS provider. After logging in, select the I am logged in checkbox in HubSpot.
    • In the main navigation menu of your DNS provider, navigate to DNS > DNS settings. If you can't find your DNS settings, reference the steps outlined by provider. Then, select the I'm there checkbox in HubSpot
    • Copy the value in the Value column. In your DNS provider account, then paste the value into the Value/Points To/Target field for the CNAME record of the subdomain you're connecting. Once you've entered the value into the CNAME record, select the Done checkbox in HubSpot.

      update-dns-records

Please note: if you're using Network Solutions or Namecheap for hosting, or are adding your records to GoDaddy manually, these providers add your brand domain and top level domain to the end of these DNS record automatically. You only need to enter the subdomain in the host name field in your DNS settings.

    • Once you update your DNS records, select the Done checkbox in HubSpot.
    • Verify your DNS changes, then click Done. If you see a Waiting on DNS changes error, you may need to wait a few minutes before clicking check them again.

DNS changes can take some time to process. In most cases, DNS changes will propagate within a few minutes, though it can take longer depending on your DNS provider. If it's been more than an hour and you're still seeing an error, ensure that you've set up your DNS correctly and then contact HubSpot support. 

SSL

Once your domain provisioning is complete, SSL will be enabled automatically. This usually takes a few minutes, but can take up to four hours. If you encounter any errors during the SSL provisioning process, see our troubleshooting guide for SSL certificate errors.

Learn more about SSL and domain security.

/cos-general/connect-a-domain-to-hubspot