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

# Sharing Vault Files

> Share files with team members via links or email invites, with granular permission controls.

## Sharing Methods

The Vault has a comprehensive sharing system with three approaches: share links, email invites, and public access.

### Opening the Share Dialog

* Right-click a file, then **Share**, or
* Select a file and click Share in the detail panel

The dialog has three tabs: **Links**, **People**, and **Settings**.

## Links Tab

Create shareable URLs with granular controls.

### Creating a Share Link

<Steps>
  <Step title="Set permission level">
    Choose what recipients can do:

    * **Can view** — Read-only access
    * **Can download** — View and download the file
    * **Can comment** — View and leave comments
    * **Can edit** — Full read/write access
  </Step>

  <Step title="Set expiry">
    Choose when the link expires:

    * **No expiry** — Link works indefinitely
    * **1 day** — Expires after 24 hours
    * **7 days** — Expires after one week
    * **30 days** — Expires after one month
    * **Custom date** — Pick a specific expiration date
  </Step>

  <Step title="Optional: Set limits">
    * **Max downloads** — Limit total downloads (leave blank for unlimited)
    * **Password** — Require a password to access (leave blank for none)
  </Step>

  <Step title="Optional: Toggle features">
    * **Allow download** — Whether recipients can download
    * **Allow comments** — Whether recipients can comment
  </Step>

  <Step title="Create">
    Click **Create and copy link**. The URL is generated and copied to your clipboard.
  </Step>
</Steps>

### Managing Existing Links

Active share links display with badges:

| Badge        | Color | Meaning                         |
| ------------ | ----- | ------------------------------- |
| **Expired**  | Red   | Link has passed its expiry date |
| **Revoked**  | Gray  | Link was manually disabled      |
| **Password** | Amber | Link requires a password        |

Each link has these actions:

* **Copy** — Copy the link URL
* **Revoke** — Disable the link (cannot be undone)
* **Delete** — Remove the link entirely

## People Tab

Share directly with team members via email.

### Sending Invites

<Steps>
  <Step title="Add recipients">
    Type email addresses. Press **Enter** or **comma** to add each one. Click "Add another..." for more.
  </Step>

  <Step title="Set permission">
    Choose the same permission levels as links: view, download, comment, or edit.
  </Step>

  <Step title="Set access expiry">
    Optionally set when the person's access expires.
  </Step>

  <Step title="Add a note">
    Write an optional personal message that will be included in the invite notification.
  </Step>

  <Step title="Send">
    Click **Send invite(s)**. Recipients receive a notification and can access the file immediately.
  </Step>
</Steps>

### Managing Access

The People tab lists everyone with access:

* Name and email
* Permission level
* Expiry date (if set)
* **Revoke** — Remove their access
* **Remove** — Delete the share entirely

## Settings Tab

### Visibility

Toggle between **Public** and **Private**:

* **Public** — Anyone with the URL can access (a public URL is generated)
* **Private** — Only people you explicitly share with can access

When public, you can copy the public URL directly.

### Access Summary

Quick stats showing:

* **Active links** — Number of active share links
* **People invited** — Number of email invites
* **Total views** — How many times the file has been accessed

### Danger Zone

**Revoke all access** — Immediately disables all share links and removes all people's access. Cannot be undone.

## Vault-Level Sharing

Entire vaults can be shared:

1. Hover over a vault in the sidebar
2. Click the three-dot menu
3. Select **Share vault** or **Manage members**

When a vault is shared, all files within it are accessible to shared users (subject to individual file permission overrides).