Add a Category #

Categories help organize your documentation into logical sections, making it easier for visitors to browse content and find relevant articles. SigmaDocs supports both parent categories and nested (child) categories, allowing you to build a structured documentation hierarchy.

The Categories page lets you create, edit, and manage all documentation categories from a single interface.

Categories Page #

The page contains a form for creating a new category with the following fields:

  • Name – The display name of the category.
  • Slug – The SEO-friendly URL identifier.
  • Parent Category – Create hierarchical documentation by assigning a parent category.
  • Description – A short description of the category.
  • Icon/Image – Upload an icon or thumbnail to visually represent the category.
  • Status – Enable or disable the category.
  • Add Category – Saves the category.

Step 1: Open the Categories Page #

  1. Log in to the SigmaDocs Admin Dashboard.
  2. From the left navigation menu, click Content → Categories.
  3. The Add Category form will be displayed.

Step 2: Enter the Category Name #

In the Name field, enter the title of your documentation category.

Examples #

  • Getting Started
  • Installation
  • API Reference
  • Tutorials
  • Components
  • Authentication

Choose a short, descriptive name that clearly represents the articles inside the category.

Step 3: Enter the Slug #

The slug is used in the category URL.

Examples #

Getting Started → getting-started
API Reference → api-reference
User Guide → user-guide

Best Practices #

  • Use lowercase letters.
  • Separate words using hyphens (-).
  • Avoid spaces and special characters.
  • Keep the slug short and descriptive.

Example URL #

https://yourdomain.com/docs/category/getting-started

Step 4: Select a Parent Category (Optional) #

SigmaDocs supports unlimited category nesting. Select an existing category from the Parent Category dropdown if you want to create a child category. Leave it as None to create a top-level category.

Documentation
├── Getting Started
│ ├── Installation
│ ├── Configuration
│ └── Deployment
├── Guides
├── API Reference
└── FAQ

Step 5: Add a Description #

Enter a brief description of the category. Descriptions help administrators understand the purpose of each category and may also be displayed on the frontend depending on your theme configuration.

Learn how to install and configure SigmaDocs on your hosting server.

Step 6: Upload an Icon or Image #

  • PNG
  • JPG
  • JPEG
  • SVG (if supported)

Recommended image size: 256 × 256 px.

Step 7: Set the Category Status #

  • Enabled – Category is visible and articles assigned to it can appear on the frontend.
  • Disabled – Category remains in the admin panel but is hidden from visitors.

Step 8: Save the Category #

After completing all fields, click the Add Category button. SigmaDocs will validate your input, save the category, add it to the documentation hierarchy, and make it available when creating or editing articles.

Example #

Name: Getting Started
Slug: getting-started
Parent Category: None
Description: Documentation for first-time users
Icon: getting-started.png
Status: Enabled

Best Practices #

  • Use clear and descriptive category names.
  • Keep slugs short and SEO-friendly.
  • Create a logical hierarchy instead of placing every category at the top level.
  • Use consistent icons across all categories.
  • Disable unfinished categories instead of deleting them.
  • Avoid duplicate category names.
  • Group related articles under the same category to improve navigation.

Tips #

  • Create your main categories before writing articles.
  • Use parent and child categories to build an organized documentation structure.
  • Keep category names consistent throughout your documentation.
  • Review your category hierarchy periodically as your documentation grows.