Skip to content

Customize knowledge base settings

Last updated: June 26, 2024

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

Service Hub   Professional , Enterprise

You can customize a knowledge base by setting the domain, visitor access, and language. You can also turn on features such as support forms and related articles. Learn more about customizing knowledge base appearance.

Set the knowledge base domain

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Content > Knowledge Base.
  • To edit your knowledge base domain, click the first dropdown menu and select a domain. Learn more about connecting a domain
  • To edit the knowledge base's URL, enter a URL slug in the Knowledge base slug field. 

set-knowledge-base-domain

  • In the bottom left, click Save. This will immediately change the URLs of your live knowledge base articles. 

Customize knowledge base access

If you have a custom domain connected for your knowledge base, you can restrict access to some or all of its content. Learn more about setting up private content for knowledge bases

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Content > Knowledge Base.
  • Select an access option for visitors: 
    • Public and private: for each article, you can select whether it's available to all visitors or only visible to registered users. 
    • Private-only: all articles are visible to registered users only.
  • Select an access option for search engines: 
    • Block knowledge base search result pages from appearing in Google and other search engines: a no index tag will be added to the search results page of your knowledge base. This will prevent this page from appearing in search engine results. This is the default option and is recommended to avoid security and user experience issues. 
    • Allow knowledge base search result pages from appearing in Google and other search engines: the no index tag will be removed from the search results page of your knowledge base. This will instruct search engines to crawl this page. 

Please note: this setting only applies to your knowledge base's search results page. All other knowledge base pages will be searchable unless specified in your robots.txt file

Set the knowledge base language

You can manually set the primary language for your knowledge base. In order for a language to be used as a primary language, all categories must be translated into that language. 

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Content > Knowledge Base.
  • In the Language section, select the Use language slug in URL checkbox. HubSpot recommends using a language slug in the URL if your knowledge base's primary language is different from your domain's primary language.
  • To edit the primary language for your knowledge base:
    • Click Add language in the Other languages section.
    • In the dialog box, click the Language dropdown menu and select your language, then click Add.
    • In the bottom left of your knowledge base settings, click Save.
    • In the Primary language section, click Edit
    • In the dialog box, click the Language dropdown menu and select your language, then click Yes, change language
    • In the bottom left of your knowledge base settings, click Save.

Use a support form

You can add a support form to your knowledge base so visitors can contact your team if they can't find an answer to their question. Learn more about adding a support form to a knowledge base.

Turn on related articles

You can add a related articles section at the bottom of every article. This section will contain articles with similar content to the current article. Related articles are automatically adjusted based on visitor attributes and article performance.

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Content > Knowledge Base.
  • In the Related Articles section, click to toggle the switch on. 

Customize article feedback consent

Please note: in certain cases, the language of your consent settings may not match your knowledge base language. To ensure compliance, consult with your legal team. Read more about your compliance obligations in HubSpot’s Data Processing Agreement.

At the end of each article, customers will be asked for feedback on the usefulness of the article. This cannot be removed from your articles or edited.

When an unknown visitor leaves feedback, they will be asked for their email address. A contact record is created and their feedback is stored. You can customize the type of consent you require for this data: 

  • In your HubSpot account, click the settings settings icon in the top navigation bar.
  • In the left sidebar menu, navigate to Content > Knowledge Base.
  • In your knowledge base settings, click the Feedback tab.
  • Click the Data privacy and consent dropdown menu and select an option

The preview will show how the current consent option will appear to visitors. 

data-privacy-and-consent-for-kb-feedback

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