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

---

# Share Links

A share link is a token URL that lets someone past a gated public wiki without an account and without knowing the password. It is the right tool when a wiki is not open to everyone but you still want to give a specific person or group a way in.

Share links apply to **public documentation wikis only**, and only when the wiki is gated, meaning its [visibility](/access-sharing/visibility-and-access) is set to something other than fully public. A fully public wiki needs no link, and internal wikis are never reachable this way, see [Public vs Internal Wikis](/access-sharing/public-vs-internal-wikis).

## Creating a link

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

- **Label**, optional. A short note so you remember who the link is for, for example `ACME contractor`. Up to 80 characters.
- **Expiry**. Choose **Never**, **7 days**, **30 days** (the default), or **90 days**.
- **Max uses**, optional. Cap how many times the link can be redeemed. Leave it empty for unlimited.

Create the link and copy it. The URL points at the wiki host with a token attached:

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

## How redemption works

When someone opens the link, Zuwiki validates the token, unlocks the wiki for them, and removes the token from the address bar so it is not left lying around in the URL. The unlock is stored in a cookie in that browser, so they stay in without re entering the link. The cookie lasts until the link expires or 30 days, whichever comes first.

Each redemption counts against the link. Once a link is expired or has reached its use cap, it stops working and shows an invalid or expired message instead of unlocking anything.

## Managing links

In the same section you see every active link with its label, how many times it has been used, and when it expires. From there you can:

- **Copy** the link again.
- **Revoke** the link. Revoking takes effect immediately for new redemptions. People who already unlocked the wiki keep their existing access until their cookie expires.

## Good to know

- A share link unlocks the wiki, it does not create an account. The visitor is anonymous and only sees what that wiki exposes.
- Use a separate labelled link per audience. If one needs to be cut off, you revoke only that link.
- Prefer a sensible expiry and use cap over a link that never dies. A short lived link is easier to reason about later.