Manage knowledge base categories, subcategories, and tags

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

Before you get started

Before you begin working with knowledge base categories, subcategories, and tags, review the requirements and considerations. 

Understand limitations & considerations

• Categories or subcategories won't be visible on your live knowledge base if they don't have at least one article associated.
• Each knowledge base supports up to 1,000 categories.
• Each knowledge base article supports up to 100 tags and each HubSpot account supports up to 5,000 tags. 
• A category or subcategory can’t be deleted while articles are still associated with it, including archived. Reassign or permanently delete the articles first.

Create and customize knowledge base categories

1. In your HubSpot account, navigate to Service > Knowledge Base.
2. In the top right, click the Configure dropdown menu and select Categories. 
3. 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. 

4. To reorder your categories, click a category in the left sidebar to drag it to its new position. By default, categories are organized alphabetically.
5. To edit a category, click a category in the left sidebar. Then click Edit category in the top right: 

• • In the dialog box, on the left menu, edit text in the Category name and Category description fields. If you have a multi-language knowledge base, you can enter a separate name and description for each language
  • When finished, click Update category.

6. To edit category appearance, icons, or featured articles, click Edit category in the top right: 
   • In the dialog box, on the left menu, click Knowledge base home display.
   • 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. 
   • When finished, click Update category.

7. To delete a category, in the left sidebar, hover over the category and click Delete. All articles and subcategories must be removed from a category before it can be deleted.

Create and customize knowledge base subcategories

Organize your knowledge base articles additionally by dividing categories into subcategories. By default, subcategories and articles are ordered alphabetically.

1. In your HubSpot account, navigate to Service > Knowledge Base.
2. In the upper right, click the Configure dropdown menu and select Categories.
3. In the left sidebar, select a category. Current subcategories will appear on the right. 
4. To create a new subcategory, click Create subcategory in the top right.

• • 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.
  • When finished, click Create subcategory. 

5. To reorder subcategories and articles, click a subcategory or article, then drag it to its new position. 
6. To change an article's category or subcategory:
   • Hover over the article within the subcategory and click Move.
   • In the dialog box, click the Category dropdown menu and select a category. To change the subcategory, click the Subcategory dropdown menu and select a subcategory.
   • When finished, click Move.
7. To set your changes live, click Update template in the top right.

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. 

1. In your HubSpot account, navigate to Service > Knowledge Base.
2. Click the name of an article. 
3. In the content editor, click the Settings in the top right.
4. In dialog box, click Tags & metadata in the left menu.
5. 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.
6. To set your changes live, click Update template in the top right. 

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