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

# Sharing & Collaboration

> Share files, folders, workspaces, and external links with role-based permissions.

# Sharing & Collaboration

Relay supports link-based sharing with role-based access control. You can share individual files, folders, entire workspace snapshots, or external links from Google Drive and other providers.

## Sharing content types

| Type                   | Description                                                                                                            |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Relay Asset**        | Share a single file from Relay Drive                                                                                   |
| **Relay Folder**       | Share an entire folder with its contents                                                                               |
| **Workspace Snapshot** | Share your current multi-pane layout — camera positions, channel configs, annotations, and all open files (up to 5 MB) |
| **External Link**      | Share a file from Google Drive, Dropbox, OneDrive, or any HTTP URL                                                     |

### Workspace snapshots

Workspace snapshots capture your entire analysis state:

* Multi-pane layout and positions
* Camera state per pane (zoom, pan, rotation)
* Channel visibility and color settings
* Image adjustments (brightness, contrast, gamma)
* Annotations and overlays

Recipients see exactly what you see — same layout, same zoom, same channels.

## Access roles

| Role          | Permissions                                            |
| ------------- | ------------------------------------------------------ |
| **Viewer**    | View the shared content. Read comments. Cannot modify. |
| **Commenter** | View and add comments. Cannot modify content.          |
| **Editor**    | Full access to view, comment, and modify.              |

## Creating a share

1. Select a file, folder, or workspace to share
2. Click the **Share** button
3. Choose the access role (viewer, commenter, or editor)
4. Configure options:
   * **Expiration** — set the share to expire after a number of days, or never
   * **Allow download** — toggle whether recipients can download files
5. Copy the generated share link

## Share management

* **Token rotation** — invalidate the current link and generate a new one
* **Revoke** — permanently delete the share link
* **Member management** — invite specific users with per-user roles
* **Audit trail** — view who accessed the share, when, and from where

## Audit log

Every share link tracks access events:

| Field      | Description                    |
| ---------- | ------------------------------ |
| Event type | `link.view`, `comment`, `edit` |
| Timestamp  | When the event occurred        |
| IP address | Visitor's IP                   |
| User agent | Browser/device info            |

Access the audit summary to see total views, comments, and edits per share.

## Google Drive sharing

When sharing a Google Drive file through Relay:

1. Relay checks if the file has a public sharing permission
2. If not, you'll be prompted to either:
   * Create a public link on Google Drive
   * Use invite-only access
3. For workspace snapshots with multiple Google Drive files, permissions are batched

## Viewing shared content

When someone opens a share link:

* The file loads in a full viewer with all visualization features
* No Relay account is required to view shared content
* Comments are visible (read-only for viewer role)
* Annotations are visible but cannot be modified (for viewer role)
* Downloads are available if the share creator allowed them
* Content is served with Range request support for streaming large files