> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vizkraft.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Share links

> Share a dashboard with stakeholders via password-optional links, expiry, revoke, and delete—without building an SDK integration.

export const DocsDemoVideo = ({category = 'cookbooks', slug, caption}) => {
  const base = `/public/recordings/${category}/${slug}`;
  return <figure className="not-prose my-8 overflow-hidden rounded-xl border border-gray-200 dark:border-gray-800">
      {caption ? <figcaption className="border-b border-gray-200 bg-gray-50 px-4 py-2 text-center text-sm text-gray-600 dark:border-gray-800 dark:bg-gray-900 dark:text-gray-400">
          {caption}
        </figcaption> : null}
      <video autoPlay muted loop playsInline className="w-full dark:hidden">
        <source src={`${base}/mist.webm`} type="video/webm" />
        <source src={`${base}/mist.mp4`} type="video/mp4" />
      </video>
      <video autoPlay muted loop playsInline className="hidden w-full dark:block">
        <source src={`${base}/carbon.webm`} type="video/webm" />
        <source src={`${base}/carbon.mp4`} type="video/mp4" />
      </video>
    </figure>;
};

Share links are for humans who need a URL. They are **not** a replacement for multi-tenant [@vizkraft/embed](https://www.npmjs.com/package/@vizkraft/embed) sessions. Use the SDK when a partner app must mint liquid-scoped sessions. See [Overview](/embed/overview).

Open [app.vizkraft.com](https://app.vizkraft.com) → dashboard → **Share**.

<DocsDemoVideo category="embed" slug="share-unlock" caption="Create a share link and unlock as a recipient" />

## Create a link

<img src="https://mintcdn.com/na-13f69f9a/d8x3eivmu3ABy64I/public/screenshots/embed/share-page.png?fit=max&auto=format&n=d8x3eivmu3ABy64I&q=85&s=6cfa73a8bf8f72d805880bb3dc88d76b" alt="Share page" width="3024" height="1646" data-path="public/screenshots/embed/share-page.png" />

1. Open the dashboard and click **Share** (opens `/dashboard/[id]/share`).
2. Choose **public** or **password-protected** access.
3. Optionally set an **expiry**.
4. Click **Create link**. The full URL stays listed so you can copy it again anytime.

## Manage links

| Filter  | Meaning            |
| ------- | ------------------ |
| Active  | Usable now         |
| Expired | Past expiry        |
| Revoked | Explicitly cut off |

Actions:

* **Copy** — re-copy the stored URL
* **Revoke** — stop access (active links)
* **Delete** — permanent remove (confirm)

Pagination shows 10 links per page.

## Recipient experience

<img src="https://mintcdn.com/na-13f69f9a/d8x3eivmu3ABy64I/public/screenshots/embed/share-unlock.png?fit=max&auto=format&n=d8x3eivmu3ABy64I&q=85&s=5ad0dad20d3425adcb7970a4c9efe1b1" alt="Share unlock" width="2292" height="1646" data-path="public/screenshots/embed/share-unlock.png" />

1. Open `/share/sh_…` (no Vizkraft login).
2. If password-protected, enter the password on the unlock page.
3. Continue into the embed viewer for that dashboard.

What recipients see (title, filters, download) follows the dashboard’s [Viewer options](/embed/viewer-options). Chart failures show friendly public errors—not SQL.

## When to use which

| Need                          | Use                                                     |
| ----------------------------- | ------------------------------------------------------- |
| Partner product, many tenants | [Developer guide](/embed/developer-guide) + liquid tags |
| Board / vendor one-off link   | Share links                                             |
| Both                          | Configure embed for the product; share for humans       |

## Related

* [Security](/embed/security)
* [Admin setup](/embed/admin-setup)
* [Partner demo](/embed/partner-demo)