How categories work in documentation
Each category in a documentation set maps to one navigation tab on the public site. When you click a tab, the page tree for that category appears on the left. If there is only one category, the tab bar is hidden — the single category's pages are shown directly, giving a cleaner reading experience for simple docs.
Inside each category, pages are organized as a tree — root pages at the top level, with child pages nested underneath. There is no hard limit on tree depth.
Create a category
- Open your documentation set from Brand → Knowledge — click its name in the Knowledge bases & documentation group. (New to that menu? See what a brand is in Yaplet.)
- Click New Category. It is created straight away as a draft, with a first page in it, and opens its settings.
- Enter a name (shown as the tab label on the public site) and an optional description.
- Click Save changes.
Inside the editor the breadcrumb starts with your brand and the back arrow returns to Brand → Knowledge.
Order your categories
Categories are ordered by their Order number — lower numbers appear first (leftmost tab). To reorder:
- Use the up and down arrow icons at the end of the category's row — hover them to see Move up and Move down. The Order number itself in the categories table is read-only.
Nested pages within a category
Pages within a category form a hierarchy. A few things to know:
- Root pages are the top-level entries in the tree. They can have child pages, which can have their own children.
- Empty parent pages are allowed — a page without content acts as a folder-only container. Its children are still navigable and readable.
- To add a child page, open the three-dot menu on the parent page and choose Add Child. For pages that already have children, an inline Add Child link also appears at the end of the child list.
- To reorder pages, use the Move Up / Move Down options in the page's three-dot menu — this reorders siblings within the same parent.
Delete a category
Click the trash icon (Delete Category) at the end of the category's row and confirm.
Deleting a category permanently removes all its pages. This cannot be undone. Unpublish the category first if you want to take it offline temporarily without losing content.
For publishing categories and pages, see Make your documentation visible to visitors.