# Zuwiki

## Icons and images

> Category: Editor guide

---

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

---

# Icons and images

Icons make a sidebar easier to scan, and images make a page easier to understand.

## Wiki icon

Upload a square image when you create or edit a wiki. It appears in the wiki list, in breadcrumbs and in links between wikis. 256 by 256 pixels is plenty. The icon is shown very small, so pick something with strong contrast and no text.

## Page icons

A page icon appears next to the title in the sidebar. Use them sparingly, because when every page has one, none stands out. Good candidates are the main page of a category, runbooks people open often, and pages about something with an obvious symbol, like a database or a calendar.

## Images in pages

Images use standard Markdown:

```markdown
![Sequence diagram of the login flow](https://example.com/login.png)
```

Write real alt text. Screen readers read it, it shows when the image fails to load, and search engines use it. Wide images break on small screens, so keep diagrams narrow or split them up.

Uploaded images count towards your plan's image storage, see the [pricing page](https://zuwiki.com/pricing).
