Organizing with Categories

Categories are the primary way to organize your knowledge base content. They appear in the left sidebar navigation and help users quickly find the information they need.

How Categories Work

Each category can contain multiple articles. Categories are displayed in the left sidebar in the order you define, with articles nested under their parent category.

The hierarchy looks like this:

📚 Getting Started
   ├── Introduction
   └── Quickstart Guide
✏️ Creating Content
   ├── Creating Your First Article
   ├── Organizing with Categories
   └── Managing FAQs
🎨 Customization
   └── Custom Branding

Creating a Category

Navigate to /editor/categories in the editor interface:

1. Click "New Category" in the top right
2. Fill in the required fields:
   • Name — Display name shown in the sidebar
   • Description — Brief summary of what this category covers
   • Icon — Choose an icon to help visually identify the category
3. Click Save

Reordering Categories

You can change the order categories appear in the sidebar:

1. Go to /editor/categories
2. Drag categories up or down to reorder them
3. Changes are saved automatically

Best Practices

• Keep it simple — 4-8 categories is ideal for most knowledge bases
• Use clear names — Category names should be immediately understandable
• Think about user journeys — Order categories from basic to advanced
• Balance content — Avoid having one category with 50 articles and another with 1
• Review regularly — As your content grows, revisit your category structure

Category Metadata

Each category has the following properties:

Property	Description
id	Unique identifier (auto-generated from name)
name	Display name in the sidebar
description	Brief description shown on the home page
icon	Icon identifier for visual identification
order	Sort order in the navigation