# Zuwiki

## Share links

> Category: Access & Sharing

---

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

---

# Share links

A share link lets one person or group into a gated public wiki without an account and without the password. Use it when a wiki isn't open to everyone but you want to give someone a way in.

Share links only work for public wikis whose [visibility](/access-sharing/visibility-and-access) is something other than fully public. A fully public wiki doesn't need them, and internal wikis can't be reached this way.

## Creating one

Open the wiki settings, go to **Security** and find **Share links**. A new link has three settings:

- **Label**: optional, up to 80 characters. A note for yourself, like `ACME contractor`.
- **Expiry**: never, 7, 30 or 90 days. The default is 30 days.
- **Max uses**: optional. Leave it empty for unlimited.

Copy the link when it is created. It looks like this:

```
https://your-wiki-host/?share=THE_TOKEN
```

## What happens when someone opens it

Zuwiki checks the token, unlocks the wiki for that visitor and removes the token from the address bar so it doesn't linger in the URL. The unlock is kept in a cookie for 30 days or until the link expires, whichever comes first.

Every redemption counts against the link. Once it has expired or used up its maximum, it shows an invalid link message and unlocks nothing.

## Managing links

The same section lists every active link with its label, number of uses and expiry. You can copy a link again or revoke it. Revoking stops new redemptions immediately, but people who already unlocked the wiki keep their access until their cookie runs out.

## Good to know

A share link doesn't create an account. The visitor stays anonymous and sees only what the wiki exposes.

Make one labelled link per audience, with a sensible expiry and use limit. That way you can cut off one group without touching the others.
