Skip to content

Manage knowledge base categories, subcategories, and tags

Last updated: March 24, 2025

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

Service Hub   Professional , Enterprise

You can use categories and subcategories to organize your knowledge base. You can also use tags to improve your search results and help your users find the right articles. 

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:

Understand limitations & considerations

  • Categories or subcategories will not be visible on your live knowledge base if they do not have at least one article associated.
  • You can add up to 1,000 categories per knowledge base.
  • You can add up to 100 tags per knowledge base articles and 5,000 tags per HubSpot account. 

Create and customize knowledge base categories

You can create and edit the categories that you are using to organize your knowledge base. Each article must be assigned a category before it can be published.
  • In your HubSpot account, navigate to Content > Knowledge Base.
  • In the top right, click the Configure dropdown menu and select Categories.
  • To create a new category:
    • Click Create category in the top left.
    • In the dialog box, enter a name and description for the category. If you have a multi-language knowledge base, you can enter a separate name and description for each language. 
    • Click Create category. 

  • To reorder your categories, click a category in the left sidebar and drag and drop it to its new position. By default, categories are organized alphabetically. 
  • To edit a category's name and description:
    • In the left sidebar, select the category.
    • In the top right, click Edit category. 

    • In the dialog box, edit the name and description. If you have a multi-language knowledge base, you can enter a separate name and description for each language.
    • Click Update category.
  • To edit category appearance, icons, or featured articles:
    • In the left sidebar, select the category.
    • In the top right, click Edit category.
    • In the dialog box, click Knowledge base home display in the left sidebar.
    • To display the category on your knowledge base homepage, click to toggle the Feature category on knowledge base home switch on.
    • If your layout contains icons, select Choose icons from library to use a standard icon, or Add your own images to upload a custom icon. To change the color of a standard icon, enter a hex value or click the color picker and select a color.
    • If your layout contains featured articles, click Add article in the Home page category articles section to set up to five featured articles. 
    • Click Update category.

  • To delete a category, hover over the category and click Delete. All articles and subcategories must be removed from a category before it can be deleted. 
  • To set your changes live in your knowledge base, click Update in the top right. 

Create and customize knowledge base subcategories

You can further organize your knowledge base articles by dividing categories into subcategories. By default, subcategories and articles are ordered alphabetically

  • In your HubSpot account, navigate to Content > Knowledge Base.
  • In the upper right, click the Configure dropdown menu and select Categories.
  • To create a new subcategory: 
    • In the left sidebar, select a category. Current subcategories will appear on the right. 
    • In the top right, click Create subcategory. 
    • In the dialog box, enter a subcategory name. If you have a multi-language knowledge base, you can enter a separate name for each language.
    • Click Create subcategory
  • To reorder subcategories and articles: 
    • In the left sidebar, select a category. Current subcategories and their associated articles will appear on the right. 
    • Click a subcategory or article, then and drag and drop it to its new position.

  • To change an article's category or subcategory:
    • Hover over the article and click Move.
    • In the dialog box, click the Category dropdown menu and select a category.
    • To also move the article into a subcategory, click the Subcategory dropdown menu and select a subcategory.
    • Click Move.

Please note: when you move an article into a different category and/or subcategory, the article URL will not be modified. Any changes to the article URL must be made in the article editor.

Create and customize knowledge base tags

To improve search results for your visitors, you can tag articles with keywords and phrases that readers would typically use to find them. 

Please note: tags will not be visible to visitors, they are used to improve search results only.

  • In your HubSpot account, navigate to Content > Knowledge Base.
  • Click the name of an article. 
  • In the content editor, click the Settings menu and select Tags & metadata.
  • In the dialog box, click the Tags dropdown menu and select an existing tag. To create a new tag, type the name of your new tag, then click + Add "[tag name]" tag.

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