1. Help
  2. Service Hub Onboarding

Connect or add a subdomain for your knowledge base

What is a Subdomain?

Before we move into the steps of connecting your subdomain to HubSpot, it's important to understand how the subdomain is different from the company’s root domain. The following diagram shows the breakdown of the subdomain, domain, and top-level domain with an example.

1665161251082 (1) 
  • The root domain includes the main domain and the top-level domain. ‘learners.ai’ is the root domain in this example.

  • The Top-level Domain (TLD) is the suffix or extension of a domain. ‘ai’ is the TLD in the above-mentioned example.

  • The subdomain is an optional addition to the main domain to have more organized content. ‘blog’ is the subdomain in this example. 


How to Connect and Configure Subdomain in HubSpot?

This section covers the steps of connecting and configuring a subdomain in HubSpot. The steps are as follows:

  1. Click on the gear icon (⛭) in the top right corner of your HubSpot dashboard.

    1665161288957 (1) 

  2. Scroll down to select Knowledge Base under the Website in the Tools section from the left sidebar.

    1665161599493 (1)

  3. This will open the Knowledge base page. Click on the Manage domain button. 

    1665164842783 (1)

  4. This will open the domains page. Click on Connect a domain button. 

    1665163632133 (1) 

  5. Select Primary from the domain type option.

    domain type option 

  6. HubSpot will ask you regards the type of content you intend to add to the subdomain. The Knowledge base and customer portal have been selected in this case. 

    1665163909546 (1) 

  7. If you haven't added the domain before, the domain you enter in the input box will be set up as your brand domain. 

    1665163909546 (1) 

  8. Enter the domain in the input box.

    1665163909546 (1) 

  9. Enter the subdomain of your choice.

  10. The brand domain will showcase here in a non-editable format.

  11. Enter the TLD of your choice.

  12. Select the language. Note this language will help the search engine know what language your content is written in. It is set to English by default.

    1665164367208 (1)

  13. The complete URL will display for you to verify. In case of any problems, you can go back and change as required.

    1665164472272 (1) 

  14. The DNS information will be displayed that you need to add to your domain provider. To gain more information about this, refer to Updating DNS Record in Domain Provider heading.

    1665164526261 (1) 

  15. It will take some time for your DNS records to update and for the subdomain to be set up.

    1665164603907 (1) 

  16. Once your subdomain is connected, go back to the Knowledge Base section under the Website in the Tools section from the left sidebar. Here you will see the updated knowledge base domain.

    1665164927778 (1) (1)