# Zuwiki

## Icons and Visual Touches

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

---

# Icons and Visual Touches

Small visual cues make a sidebar scannable. Zuwiki supports icons on wikis and on individual pages.

## Wiki icon

Upload a square image when you create or edit a wiki. The icon shows up in the wiki list, in breadcrumbs, and in cross wiki links.

Recommendations:

- Square aspect ratio, 256 by 256 pixels is plenty.
- High contrast, the icon is rendered very small.
- Avoid text, it becomes unreadable at sidebar size.

## Page icon

A page icon shows next to the title in the sidebar. Use it sparingly. If every page has an icon, none of them stand out.

Good candidates for an icon:

- Top level pages of a category.
- High traffic runbooks.
- Pages that map to a real concept with a recognizable symbol, for example a database, a calendar, or a rocket for a launch checklist.

## Images inside pages

Inline images use standard Markdown:

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

The alt text matters. It is read by screen readers, it is shown when the image fails to load, and it is what search engines see.

Keep large diagrams as separate images instead of stretching them across the page. Wide images look fine on a desktop and break on smaller screens.