Knowledge Base
Categories
Organize your knowledge base with categories
Categories help customers browse your knowledge base and find relevant articles. A clear category structure improves both self-service and AI accuracy.
Creating Categories
- Go to Knowledge Base > Categories
- Click New Category
- Enter a name and description
- Choose an icon (optional)
- Set the display order
- Click Create
Category Properties
| Property | Description |
|---|---|
| Name | Displayed to customers |
| Slug | URL-friendly identifier |
| Description | Brief summary shown on browse page |
| Icon | Visual identifier (optional) |
| Order | Position in the navigation |
| Visibility | Public, internal, or hidden |
Subcategories
Create nested organization:
Billing (Category)
├── Payments (Subcategory)
├── Invoices (Subcategory)
└── Refunds (Subcategory)To create a subcategory:
- Click on an existing category
- Click Add Subcategory
- Enter details and save
Tip: Limit nesting to 2 levels for easy navigation.
Recommended Structure
Most knowledge bases work well with these categories:
| Category | Contents |
|---|---|
| Getting Started | Onboarding, setup, basics |
| Account | Login, profile, settings |
| Billing | Payments, invoices, plans |
| Features | How to use each feature |
| Troubleshooting | Common problems and fixes |
| API & Developers | Technical documentation |
| Policies | Terms, privacy, shipping |
Moving Articles
Reorganize articles between categories:
- Open the article you want to move
- Click Settings > Category
- Select the new category
- Click Save
Or use bulk move:
- Go to Knowledge Base > Articles
- Select multiple articles
- Click Move to Category
- Choose destination
Category Visibility
Control who sees each category:
| Visibility | Who Can Access |
|---|---|
| Public | All customers |
| Authenticated | Logged-in customers only |
| Internal | Team members only |
| Hidden | Accessible via direct link |
Set visibility when creating or editing a category.
Category Analytics
Track performance by category:
- Views - How often the category is browsed
- Article count - Number of articles
- Search clicks - How often search leads here
- AI citations - How often AI references articles
Access analytics at Knowledge Base > Analytics.
Reordering Categories
Change the display order:
- Go to Knowledge Base > Categories
- Drag categories to reorder
- Changes save automatically
Or set explicit order numbers in category settings.
Merging Categories
Combine two categories:
- Go to the category you want to remove
- Click Settings > Merge
- Select the destination category
- All articles move to the destination
- Original category is deleted
Deleting Categories
Remove empty categories:
- Move or delete all articles first
- Go to category settings
- Click Delete Category
- Confirm deletion
Note: Categories with articles cannot be deleted directly.
Best Practices
- Keep it simple - 5-10 top-level categories is ideal
- Use customer language - Match how they describe topics
- Review quarterly - Reorganize as your product evolves
- Check empty categories - Remove or populate them
- Balance article count - Avoid one huge category