How categories work
A knowledge base is organized as a hierarchy:
Knowledge base → Category → Sub-category → Articles
Categories can be nested up to four levels deep. Articles can live at any level — you do not need to reach the deepest sub-category before adding articles. Visitors walk this hierarchy in the widget's Help tab and on your public page.
Create a top-level category
- Go to Brand → Knowledge and click your knowledge base to open it. (New to that menu? See what a brand is in Yaplet.)
- Click New Category.
- The category is created straight away with a placeholder name, and its Settings page opens.
- Give it a name and an optional description, then save. The description appears under the category name on the public page and helps visitors decide whether they are in the right place.
Create a sub-category
- Click into an existing category to open it.
- In the Subcategories section, click New Category.
- Name it on the Settings page that opens, then save.
Repeat to nest further. If you try to go deeper than four levels, Yaplet refuses with the message "Maximum nesting depth reached — Categories cannot be nested more than 4 levels deep." At that point you can only add articles.
Set the display order
You set the order of categories and articles with the arrows.
- Use the up and down arrow buttons at the end of any category row. Hover over them to see Move category up / Move category down (on the knowledge base's top level they read Move up / Move down).
- Articles have the same pair of arrows on their own rows. They are switched off on translated versions — a translation always sits with the original it belongs to.
Order is independent at each level: categories inside one parent are ordered separately from categories inside another.
Edit and delete categories
Each category row ends with small icon buttons. The cog opens Settings (rename, change description), and the trash can is Delete (on a subcategory row its tooltip reads Delete category). Delete asks you to confirm first.
Deleting a category permanently removes every sub-category underneath it and every article inside them. This cannot be undone. Move anything you want to keep before deleting. Deleting the whole knowledge base is a separate action, in the ⋯ menu of its row on Brand → Knowledge, and that confirmation tells you how many articles go with it.
Tips for a clean structure
- Use nouns for category names — "Installation", "Billing", "Account settings" — not verbs. Noun names scale better as you add more articles.
- Keep top-level categories to 5–8 — more than that, and visitors start guessing which category to pick.
- One concept per category — if a category has only one article, it might belong in its parent instead.