# Wikis

A wiki is a collection of pages about one subject. Each organization has a `general` wiki, and you can create more, such as `finance`, `product`, or one for each customer project.

Each wiki has its own access settings, so you can create a wiki for a subject that only some people should read.

## Wiki properties

| Property | Description |
|---|---|
| Name | The wiki's address, used in paths. Lowercase letters, digits, and hyphens, for example `customer-acme`. |
| Title | The display name, for example `Customer: Acme`. |
| Description | What belongs in the wiki and who reads it. Agents use it to decide where to write. |
| Access | Open to the whole organization, or restricted to specific people and teams. |

To change access, see [Access and sharing](https://known.info/docs/access).

A page's path starts with its wiki's name. For example, `finance:budget.2026` is the page `budget.2026` in the `finance` wiki.

## Create a wiki

Only organization admins can create wikis. Ask your agent to create one, or use the CLI:

```
known acme wiki create finance --title "Finance" \
  --description "Budgets, pricing, and the monthly close. Read by founders and finance."
```

To create a restricted wiki, add `--restricted` and at least one grant, for example `--grant team:founders:author`.

## Update a wiki's title or description

Anyone who can write in a wiki can change its title and description:

```
known acme wiki update finance --description "Budgets, pricing, and the monthly close."
```

Write a description that says what the wiki contains and who it's for. Agents read it when deciding where a page belongs.

## Browse wikis

In the browser, click **Wikis** to see your organization's wikis. Inside a wiki, the sidebar shows its pages. The **Notes** and **Changes** tabs show open feedback and recent changes.

From the CLI:

```
known acme wiki wikis
known acme wiki tree finance:
```

`wiki wikis` lists each wiki with its description, who can read it, and what changed since you last looked. `wiki tree` shows a wiki's pages.

## When to create a new wiki

Create a new wiki when a subject needs different readers from the rest of the organization, or when it's large enough that people go to it directly. Otherwise, add a page to an existing wiki. Pages can contain other pages, so a single page like `general:handbook` can hold an entire handbook.

## FAQ

### Can I rename or delete a wiki?

Not yet. You can move and rename pages within a wiki. See [Pages](https://known.info/docs/pages).

### Can the `general` wiki be restricted?

No. Every member of the organization can always read and write `general`.

### Can organization admins read restricted wikis?

Only if they're granted access. Admins can see that a restricted wiki exists and who has access, and they can change access. If an admin grants themselves access, the wiki's owners can see that they did.