Customize a knowledge base

You can customize the appearance of your knowledge base by selecting your layout and configuring your theme in the theme editor.

Before you get started

Before you begin working with this feature, make sure to fully understand what steps should be taken ahead of time, as well as the limitations of the feature and potential consequences of using it.

Understand requirements

Verify that you have one of the following user permissions:

• Super Admin permissions.
• Knowledge base settings and Global content and theme settings permissions. 

Understand limitations & considerations

• Currently, you cannot customize your knowledge base in the design manager or use custom themes.

Edit your knowledge base theme settings

Once you've created your knowledge base, you can edit your theme settings to customize its appearance. Currently, only one default theme is available to customize.

• In your HubSpot account, navigate to Content > Knowledge Base.
• In the top right, click the Configure dropdown menu and select Theme.
• To change the template of the sample content, click the View on dropdown menu in the top left and select a template. Changes to the theme will be applied to all knowledge base templates.
• To change the language of the sample content, click the second dropdown menu in the top left and select a language.
• To change the screen size of the sample content, click the desktop device icons at the top of the editor, or enter a screen width in pixels. 

You can customize the following aspects of your knowledge base templates: 

• Colors: select primary, secondary, accent, and background colors for your templates. You can select from simple or brand colors, or input custom hex values. 
• Typography: select fonts for page elements like headings and links, as well as sizes, styles, and colors. 
• Layout: select the layout for your homepage. Different layouts will support different styling options. 
• Header: select style elements for your header content, including the search bar. Learn more about customizing the content of your header. 
• Footer: select style elements for your footer content, including social icons. Learn more about customizing the content of your footer. 

When you're finished customizing your theme, click Publish theme in the top right. 

Edit your knowledge base header

You can edit the content of your knowledge base header and see it reflected across all knowledge base pages.

• In your HubSpot account, navigate to Content > Knowledge Base.
• In the top right, click the Configure dropdown menu and select Header.
• In the global content editor, click the siteTree contents icon in the left sidebar.
• In the left sidebar, click the Website header module.
• Edit your header options, then click Apply options at the bottom of the sidebar editor to see your changes.
• When you've completed your edits, click Publish to [#] assets in the top right.

You can customize the following options for your header:

• Logo: upload a custom logo for your knowledge base and add a link to your logo.
• Additional support options: add sign-in options for customer portal or private content and set up a support form to create tickets.
• To add sign-in options for your customer portal, click to toggle the Show your customer portal link switch on.
• To add sign-in options for private content, click to toggle the Show sign-in for restricted content switch on.
• To set up a support form to create tickets, click to toggle the Support form switch on. 
  
  • Click the Form dropdown menu and select an existing form, or click Create new to create a new form. 
  • In the What will a visitor see after submitting your form? section, select Redirect visitors to another page or Display an inline thank you message.
• Menu: set up your navigation menu in your website settings. You can also select existing navigation menus.
• Button: add a button to your header and configure its link and icon.
• Language switcher: add a language switcher and configure its display mode:
  • Localized: the name of each language will appear in that language.
  • Pagelang: the name of each language will appear in the language of the current page.
  • Hybrid: the name of each language will appear in the language of the current page, as well as in that language.

Edit your knowledge base footer

You can edit the content of your knowledge base footer and see it reflected across all knowledge base pages.

• In your HubSpot account, navigate to Content > Knowledge Base.
• In the top right, click the Configure dropdown menu and select Footer.
• In the global content editor, click the siteTree contents icon in the left sidebar.
• In the left sidebar, edit the following modules:
  • Footer menu: set up your navigation menu in your website settings. You can also select existing navigation menus.
  • Logo: upload a custom logo for your knowledge base and add a link to your logo.
  • Rich Text: add custom text, such as your company's address.
  • Social follow: add links to your company’s social media profiles.