Organize categories and sub-categories

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

1. Go to Brand → Knowledge and click your knowledge base to open it. (New to that menu? See what a brand is in Yaplet.)
2. Click New Category.
3. The category is created straight away with a placeholder name, and its Settings page opens.
4. 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

1. Click into an existing category to open it.
2. In the Subcategories section, click New Category.
3. 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

Categories and articles are ordered by a weight number: lower comes first. You change it with the arrows, not by typing a number.

• Use the Move category up / Move category down arrows on any category row.
• 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

Open the three-dot menu next to a category to reach Settings (rename, change description) or Delete.

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, on 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.