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

---

# Wikis, Categories, and Pages

Zuwiki content is built from three things: wikis at the top, categories inside them, and pages where the actual writing lives.

## Wiki

A wiki is the outer container. It belongs to exactly one organization, has a title, an optional icon, and a unique slug used in URLs. Members of the organization see the wikis they have access to in the sidebar.

Every wiki also has a **mode**: **Public documentation** or **Internal knowledge**. The mode is the defining choice for a wiki, because it decides where the wiki is served and how access works. See [Public vs Internal Wikis](/access-sharing/public-vs-internal-wikis).

Use one wiki when:

- The content is for the same audience.
- The same group of people maintains it.
- A reader looking for any of the pages would start in the same place.

## Category

A category is a sidebar group inside a wiki. Categories cannot nest, they sit at one level only. This is intentional: navigating two clicks deep is fast, navigating five clicks deep is not.

Categories have a name, a slug, a sort order, and on a public wiki their own visibility. Reorder them at any time and the sidebar follows.

## Page

A page is the smallest unit of content. Pages can live directly in a wiki as root pages, or inside a category, and they can have child pages.

Each page has:

- a **title** and a generated **slug**
- a **type**: a normal Markdown page, or an [OpenAPI spec viewer](/editor-guide/openapi-pages)
- a **status**: draft, published, or archived
- a **history**, one entry per save
- an optional **icon** for the sidebar

Who can read a page depends on the wiki's mode. On a public wiki, a page also carries a [visibility](/access-sharing/visibility-and-access). On an internal wiki, access is governed by [access grants](/access-sharing/access-grants).

When you nest pages, the parent does not magically aggregate its children. Think of nesting as a way to express **this page is a sub topic of that page**, not as a folder system.

## Picking the right shape

If you find yourself unsure whether something should be a new wiki, category, or page:

- Different audience, or public versus internal? New wiki, and pick its mode.
- Same audience, new topic? New category.
- Refinement of an existing topic? New page, possibly nested.