User ManualPodWarden Hub
Admin: Categories
Category CRUD with private catalog access management per organization
What you see
URL: /dashboard/admin/categories (requires admin or superadmin role)
The Admin Categories page lets you create, edit, and delete template categories. Categories organize the template catalog and appear in the sidebar filter on the catalog and template pages.
The page has a header with the title and an "Add Category" button. Below that is a card listing all categories with their template counts and action buttons.
Fields / columns
Each category row shows:
| Field | Description |
|---|---|
| Icon | Category icon (Lucide icon name) |
| Name | Category display name |
| Slug | URL-friendly identifier |
| Sort order | Numeric value controlling display order in the sidebar |
| Description | Brief category description |
| Template count | Number of templates assigned to this category |
| Private | Whether the category is private (requires explicit org access) |
| Access count | Number of organizations with access (private categories only) |
Available actions
| Action | Where | What it does |
|---|---|---|
| Add Category | Page header button | Opens the create modal with empty fields |
| Edit | Pencil icon per row | Opens the edit modal pre-filled with category data |
| Delete | Trash icon per row | Deletes the category. Disabled if the category has templates. |
| Manage access | Users icon per row (private categories only) | Opens the access management modal |
Create/Edit modal fields
| Field | Description |
|---|---|
| Name | Category display name |
| Slug | URL-friendly identifier. Auto-generated from name on create, editable on update. |
| Description | Brief description |
| Icon | Lucide icon name (e.g. Brain) |
| Sort Order | Numeric display order |
| Private catalog | Checkbox. When checked, only organizations with explicit access can see templates in this category. |
Access management modal
For private categories, the access modal shows:
- A list of organizations that currently have access, each with a revoke button.
- A dropdown to select an organization and a "Grant" button to add access.
| Action | What it does |
|---|---|
| Grant | Gives the selected organization access to this private category |
| Revoke | Removes an organization's access to this private category |
Status badges
| Badge | Meaning |
|---|---|
| Private | Category is restricted to organizations with explicit access |
| N templates | Number of templates in the category |
Related docs
- Admin Templates -- Template management (each template belongs to a category)
- Admin Organizations -- Manage org access to private catalogs from the org side
- Catalog -- Public catalog filtered by categories