# Zuwiki

## Organize with Categories

> Category: Getting Started

---

## Pages

- [Welcome to Zuwiki](https://docs.zuwiki.com/welcome-to-zuwiki)

### Getting Started

- [Create Your First Wiki](https://docs.zuwiki.com/getting-started/create-your-first-wiki)
- [Organize with Categories](https://docs.zuwiki.com/getting-started/organize-with-categories)
- [Publish Your First Page](https://docs.zuwiki.com/getting-started/publish-your-first-page)

### Core Concepts

- [Wikis, Categories, and Pages](https://docs.zuwiki.com/core-concepts/wikis-categories-and-pages)
- [Page Lifecycle](https://docs.zuwiki.com/core-concepts/page-lifecycle)
- [Page History and Restore](https://docs.zuwiki.com/core-concepts/page-history-and-restore)

### Access & Sharing

- [Public vs Internal Wikis](https://docs.zuwiki.com/access-sharing/public-vs-internal-wikis)
- [Visibility for Public Wikis](https://docs.zuwiki.com/access-sharing/visibility-and-access)
- [Share Links](https://docs.zuwiki.com/access-sharing/share-links)
- [Access Grants](https://docs.zuwiki.com/access-sharing/access-grants)
- [Classification and Sensitivity](https://docs.zuwiki.com/access-sharing/classification-and-sensitivity)

### Editor Guide

- [Markdown Basics](https://docs.zuwiki.com/editor-guide/markdown-basics)
- [Linking Between Pages](https://docs.zuwiki.com/editor-guide/linking-between-pages)
- [Icons and Visual Touches](https://docs.zuwiki.com/editor-guide/icons-and-visual-touches)
- [Rich Content Blocks](https://docs.zuwiki.com/editor-guide/rich-content-blocks)
- [OpenAPI Pages](https://docs.zuwiki.com/editor-guide/openapi-pages)

### Plans & Account

- [Plans and Limits](https://docs.zuwiki.com/plans-account/plans-and-limits)
- [Custom Domain](https://docs.zuwiki.com/plans-account/custom-domain)
- [Zuwiki for Open Source](https://docs.zuwiki.com/plans-account/zuwiki-for-open-source)

### Integrations

- [MCP Server](https://docs.zuwiki.com/integrations/mcp-server)

---

# Organize with Categories

Categories are the sidebar groups that hold your pages. They are the easiest way to keep a growing wiki navigable.

## When to add a category

Add a category as soon as you have two or three pages that clearly belong together. Do not create empty categories in advance, an unused container is just noise.

Good signals that it is time for a new category:

- You find yourself prefixing page titles to fake grouping, like **Hiring: Interview Loop**.
- A new reader cannot guess where a page lives.
- The root of the wiki has more than roughly seven top level items.

## How to name a category

- Use short noun phrases: **Onboarding**, **Architecture**, **Runbooks**.
- Stay parallel. If one category is a noun, the rest should be nouns too.
- Avoid clever names. **People Stuff** is fun on day one and confusing on day ninety.

## Moving pages

A page can be moved between categories at any time. Keep in mind that a page's address includes its category, so moving it changes its URL and any links that pointed at the old location need updating. See [Linking Between Pages](/editor-guide/linking-between-pages) for how that works. If a page belongs to several themes, pick the one where readers will look first and link to it from the others.

## Categories vs. nested pages

Categories are the top level grouping. Within a category, pages can still nest as parent and children. Use nesting when one page is clearly a sub topic of another, and use categories when several pages share a theme but none of them is the parent.
