# How share links work

# How share links work

A **share link** freezes the nutrition view you are looking at — date, tab layout, and last calculated meals — into a **read-only** URL anyone can open without signing in. It is a handoff snapshot, not live sync and not an API key.

## Create a link

1. Sign in and open the dashboard for the environment you want to share.
2. Set the day and tab you want frozen. Share uses your **last calculated** meals (unsaved edits are not included — you will be asked to confirm if the day is dirty).
3. Top bar **Share** → **Create share…**
4. Pick an audience preset (or Custom), give the link a title, optional description, and how long it lasts (24 hours / 7 days / 30 days).
5. **Create link** → copy the URL (or scan the QR). The raw token is shown **once**.

<OpenInApp surface="shares-create" label="Open Share in app →" />

## What the recipient sees

- Opening `/share/{token}` loads a **read-only** snapshot — they cannot edit meals or change your account.
- After they open it, your Share menu updates (for example “Opened 2h ago”).
- When the link expires or you revoke it, the public URL stops working.

## Manage links

- **Share** dropdown → **Manage all share links ›**, or **Account → Share Links**.
- There you can rename, renew the TTL, **revoke**, **rotate** (copy a new URL — the old one dies immediately), preview, and download a QR.
- Active links are capped per environment; revoke old ones if you hit the limit.

## Share links vs Integrations

| | Share links | Integrations / API keys |
|---|---|---|
| For | Humans (URL / QR) | Agents and scripts |
| Access | One frozen view | Scoped read of your data |
| Manage | Account → Share Links | Account → Integrations |

See [Integrations & Read API](/guides/account/integrations-read-api) for agent access.

## If create fails

Sharing needs a signed-in session and a successful cloud save. Commit or save the day, then try Share again. See also [Share link unavailable?](/faqs/troubleshooting#share-link-unavailable).

<Related ids={["share-links", "export-download-delete-data", "faq-troubleshooting"]} />
