Skip to content
Knowledge Base

Customize knowledge base settings

Last updated: September 8, 2021

Applies to:

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.

  • In your HubSpot account, click the settings icon settings in the main navigation bar.
  • In the left sidebar menu, navigate to Website > Knowledge base.

Set the knowledge base domain

  • To edit your knowledge base domain, click Manage domain. If you haven't connected a domain to HubSpot, click Connect domain instead. You will be redirected to your domain settings.
  • To edit your knowledge base's root URL, click Edit root URL. In the dialog box, Enter a new URL, then click Yes, save it. The root URL's language slug can be edited in the Language section of your knowledge base settings. 
edit-knowledge-base-domain

Customize knowledge base access

Manage customer access to the content on your knowledge base:

  • 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.

Manage search engine access to the search results page of your knowledge base: 

  • 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. 

  • To include a language slug in your knowledge base URL, 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.

Select a favicon

You can customize your knowledge base's favicon, the small image in the browser tab next to the page title. 

  • In the Favicon section, click Upload to upload a new image from your computer, or Browse images to select an existing image from the files tool.

Please note: for best results, a favicon should be saved as a 48 by 48 px image in one of these file formats: .ico, .gif, .png.


  • Click Save in the bottom left.
  • To remove a favicon, hover over the existing image and click the X that appears. You can then upload a new favicon.

remove-existing-favicon

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

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

Customize article feedback consent

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 knowledge base settings, click the Feedback tab.
  • Click the Notice and Consent / Legitimate interest (GDPR) dropdown menu and select an option

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

preview-gdpr-options-for-knowledge-base-feedback