Customize knowledge base settings

Customize a knowledge base by setting the domain, visitor access, and language. Turn on features such as support forms and related articles. Learn more about customizing knowledge base appearance.

Before you get started

Before you customize knowledge base settings, review the requirements and considerations.

Understand limitations & considerations

• These tools are only available for migrated knowledge bases. Learn more about migrating your knowledge base.

Set the knowledge base domain

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the left sidebar menu, navigate to Content > Knowledge Base.
3. On the General tab, click the Knowledge base domain dropdown menu and select a domain. Learn more about connecting a domain. 
4. In the Knowledge base slug field, enter a URL slug.
5. To use a language slug, 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.
6. When finished, click Save on the bottom left. This will immediately change the URLs of your live knowledge base articles. 

Customize knowledge base access

If a custom domain is connected, configure visitor access settings for the knowledge base. Learn more about setting up private content for knowledge bases. 

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the left sidebar menu, navigate to Content > Knowledge Base.
3. In the Access Control section, select an option:
   
   • Public and private: anyone can see the knowledge base, unless an individual article's access is set to Single sign-on or Access group membership required. 
   • Access group membership required: gives specific contacts access to the knowledge base using access groups. Learn more about restricting a knowledge base and articles to access groups.
   • Single sign-on (SSO) required: gives specific contacts access to the knowledge base using SSO. Learn more about restricting a knowledge base and articles to SSO.
4. In the Manage crawler access to your knowledge base section, select an option:
   • 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 to appear 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. 
5. When finished, click Save on the bottom left.

Please note: this setting applies only to knowledge base search result pages. All other knowledge base pages remain searchable unless restricted in the robots.txt file. 

Manage language variations

Add or edit language variations for your knowledge base articles. Learn more about customizing language variations for articles.

Add a support form

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

Turn on related articles and last updated date

Turn on the 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.

The article's last updated date automatically updates any time the article is published or re-published to the knowledge base.

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the left sidebar menu, navigate to Content > Knowledge Base.
3. Click the Template tab.
4. To turn on related articles for a knowledge base, toggle the Related Articles switch on.
5. To turn on the article's last updated date, toggle the Article Last Updated switch on.
6. When finished, click Save on the bottom left.

Customize article feedback consent

Customize the type of data privacy consent displayed when visitors leave feedback on your knowledge base articles.

At the end of each article, visitors are prompted for feedback. If an unknown visitor submits feedback, they're prompted to enter an email address. A contact record is created and feedback is stored. This section can't be removed or changed.

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

1. In your HubSpot account, click the settings settings icon in the top navigation bar.
2. In the left sidebar menu, navigate to Content > Knowledge Base.
3. Click the Feedback tab.
4. Click the Data privacy and consent dropdown menu and select an option:
   • Consent checkbox for communications; form submit as consent to process: shows consent to communicate checkboxes and consent to process text.
   • Consent checkboxes for communications and processing: shows consent to communicate and consent to process checkboxes.
   • Legitimate interest - Lead: shows privacy text.
   • Legitimate interest - Customer: shows privacy text.
5. In the preview section, review how the current consent option will display to visitors.
6. When finished, click Save on the bottom left.