# Zuwiki

## Wikis, categories, and pages

> Category: Core concepts

---

## 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)

### 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 images](https://docs.zuwiki.com/editor-guide/icons-and-images)
- [Rich content blocks](https://docs.zuwiki.com/editor-guide/rich-content-blocks)
- [OpenAPI pages](https://docs.zuwiki.com/editor-guide/openapi-pages)

### Plans & Account

- [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)

---

# Wikis, categories, and pages

Content in Zuwiki has three levels: wikis at the top, categories inside them, and pages where the writing happens.

## Wiki

A wiki belongs to exactly one organization. It has a title, an optional icon, a slug that ends up in its URL, and a [mode](/access-sharing/public-vs-internal-wikis) that decides where it is served and who can read it.

Keep things in one wiki when the readers are the same, the same people maintain it, and a reader looking for any of its pages would start in the same place. A different audience, or a mix of public and internal content, means a new wiki.

## Category

A category is a group in the sidebar. Categories don't nest. That is on purpose: two clicks deep is quick, five clicks deep is not.

Add a category once two or three pages clearly belong together. An empty category you created in advance is just noise. You will know it is time when:

- you start prefixing page titles to fake a grouping, like **Hiring: Interview loop**
- a new reader can't guess where a page lives
- the wiki has more than about seven items at the top level

Name categories with short noun phrases such as **Onboarding** or **Runbooks**, and keep them parallel. A clever name like **People stuff** is fun on day one and confusing on day ninety.

You can move a page between categories at any time. A page's address includes its category, so moving it changes the URL, and links that pointed at the old address need updating. More on that in [Linking between pages](/editor-guide/linking-between-pages). If a page fits several themes, put it where readers will look first and link to it from the others.

## Page

A page is the smallest unit of content. It sits at the top level of a wiki or inside a category. Each page has a title, a slug, a type (a normal Markdown page or an [OpenAPI page](/editor-guide/openapi-pages)), a [status](/core-concepts/page-lifecycle), a [history](/core-concepts/page-history-and-restore) and an optional icon.

Pages can have child pages one level down. Use that when a page is a sub topic of another one. A parent doesn't collect its children and nesting isn't a folder system. If several pages share a theme but none of them is the parent, that is what a category is for.

Who can read a page depends on the wiki's mode: [visibility](/access-sharing/visibility-and-access) on public wikis, [access grants](/access-sharing/access-grants) on internal ones.
