×

Organize Your HubSpot Knowledge Base

How to Organize Your HubSpot Knowledge Base

A well-structured knowledge base in Hubspot helps customers find answers fast and reduces support tickets. This guide shows you how to plan, create, and manage categories, subcategories, and tags so your help center stays clear, consistent, and easy to navigate.

The steps and options below are based on HubSpot’s built-in knowledge base tools and follow best practices for information architecture and SEO.

Plan Your HubSpot Knowledge Base Structure

Before you start clicking in the app, outline how you want your content organized. A solid plan will save you time later.

Define main HubSpot knowledge base topics

Begin by deciding your top-level categories. These should match how customers think about your product or service.

  • Group articles by product area or feature set.
  • Use terms your customers actually use, not just internal jargon.
  • Keep the number of top-level categories manageable, usually between 5 and 10.

Map subcategories under each HubSpot topic

Subcategories add another layer of clarity for your knowledge base readers.

  • Break down each main category into logical processes or themes.
  • Use subcategories for typical customer goals, like onboarding, billing, or integrations.
  • Avoid overlapping subcategories that could confuse search and navigation.

Decide how you will use tags in HubSpot

Tags are flexible labels that connect related articles across different categories. Plan how you will use them from the start.

  • Use tags for cross-cutting themes like “troubleshooting” or “account management.”
  • Do not duplicate category names as tags; give each system a distinct role.
  • Create a short list of standard tags and document when to apply each one.

Access the Knowledge Base in HubSpot

Once your structure is planned, sign in and open the knowledge base tool.

  1. Log in to your HubSpot account.
  2. In the main navigation, go to Service > Knowledge Base (location may vary slightly by subscription and navigation layout).
  3. Open the article listing view to see existing content, categories, and tags.

This is where you will manage categories, subcategories, and the metadata that powers search and navigation.

Create and Edit HubSpot Knowledge Base Categories

Categories are your highest-level groups. Use them to reflect your core offerings and main support themes.

How to add a new HubSpot category

  1. In the knowledge base tool, locate your list of categories or the settings for article organization.
  2. Click the option to Add category or similar action.
  3. Enter a clear, descriptive category name your customers will recognize.
  4. Add a brief description if available; this can appear in templates and help readers choose the right path.
  5. Save your new category and confirm it appears in the category list.

Best practices for HubSpot category names

  • Use concise, action-oriented terms where possible.
  • Avoid internal codes or shorthand that only your team understands.
  • Keep capitalization and style consistent across all category names.

Edit or reorder HubSpot categories

As your knowledge base grows, you may need to update existing categories.

  1. Open the category management panel in your HubSpot knowledge base.
  2. Select the category you want to edit.
  3. Update the name or description to better reflect current content.
  4. If your interface allows drag-and-drop, drag categories to reorder how they appear in navigation.
  5. Save your changes and quickly review a few live articles to confirm the new structure looks correct.

Manage Subcategories in Your HubSpot Knowledge Base

Subcategories break your categories into more specific areas and guide users to the right articles faster.

Add new HubSpot subcategories

  1. In your knowledge base settings, select the parent category where you want to add a subcategory.
  2. Click Add subcategory or the equivalent action.
  3. Enter a subcategory name that clearly fits under the chosen parent category.
  4. Optionally, add a short description to explain when to use this subcategory.
  5. Save and confirm that the subcategory appears nested under the right category.

Organize articles into HubSpot subcategories

  1. Open an article in edit mode.
  2. Locate the Category or Organization panel in the editor sidebar.
  3. Select the correct category and then the appropriate subcategory from the dropdown or tree.
  4. Update and publish the article so the new structure appears to visitors.

Apply subcategories consistently so users can predict where to find related content in HubSpot and your internal team can manage articles more easily.

Use Tags Effectively in HubSpot Knowledge Articles

Tags help connect articles across different branches of your HubSpot knowledge base and support more precise search filtering.

How to add HubSpot tags to an article

  1. Open the article you want to tag in the knowledge base editor.
  2. In the article settings panel, find the Tags field.
  3. Start typing a tag name; if it exists, select it, otherwise create a new one if your governance rules allow.
  4. Add only a small number of highly relevant tags (often 1–3).
  5. Save or update the article so the tags are applied.

Tagging guidelines for your HubSpot knowledge base

  • Use tags to reflect user intents like “getting started,” “migration,” or “billing.”
  • Avoid creating near-duplicate tags (for example, “getting-started” and “getting started”).
  • Review the active tag list regularly and merge or retire redundant ones.

Keep Your HubSpot Knowledge Base Clean Over Time

Ongoing maintenance prevents clutter and helps your HubSpot content stay accurate.

Review categories and tags regularly

  • Schedule a quarterly audit of categories, subcategories, and tags.
  • Consolidate low-usage categories or subcategories that confuse readers.
  • Align naming with changes in your product, pricing, or services.

Align HubSpot support content with analytics

Use engagement data and search reports to refine your structure.

  • Identify categories with high traffic but low success rates and reorganize them.
  • Spot common search terms and ensure they map to clear categories and tags.
  • Retire or rewrite articles that no longer match their assigned category.

Helpful Resources for Managing Your HubSpot Setup

To go deeper into the platform-specific steps for managing categories, subcategories, and tags, review the official HubSpot knowledge base documentation directly from the source:

Official HubSpot article on managing knowledge base categories, subcategories, and tags

If you want expert help designing your information architecture or optimizing your HubSpot knowledge base for search and AI, you can also consult specialized service providers:

Consultevo — consulting for knowledge base and SEO optimization

By planning a clear structure, using categories and subcategories consistently, and applying tags with intention, you can turn your HubSpot knowledge base into a reliable, self-service support channel that grows smoothly as your content library expands.

Need Help With Hubspot?

If you want expert help building, automating, or scaling your Hubspot , work with ConsultEvo, a team who has a decade of Hubspot experience.

Scale Hubspot

“`

Verified by MonsterInsights