> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/sharing-and-collaboration/published-links.md).

# Published Links

Published links are great for inviting external collaborators that need temporary access to a folder or file.

You can create a link from one of your workspace's link templates, or build a custom link with individual toggles.

### Link templates

Link templates appear in the Share dialog so you can create a link in one click. Every workspace starts with these default templates:

* **Editor**: View, download, comment, view asset details, upload, and view stack versions
* **Reviewer**: View, download, comment, view asset details, and view stack versions
* **Client**: View, download, and view asset details

Workspace admins can edit these templates or add their own (see [Workspace sharing settings](#workspace-sharing-settings) below).

### Custom link permissions

Custom links let you choose what recipients can do under **Allow users to**:

* Download assets
* Comment
* View asset details
  * Edit asset metadata
  * Visible metadata (choose which metadata fields recipients can see)
* Upload (folders only)
* View Stack Versions

<figure><img src="https://450378260-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUNq6h2Bfw7aAK0J2ffnZ%2Fuploads%2Fi4fXzcCtu1IVpdrgcYYS%2FLinks.gif?alt=media&#x26;token=e87c5e56-e589-4541-be82-61f7bb1d15e5" alt=""><figcaption></figcaption></figure>

To create a published link:

* Right click on any asset or folder and click **Share** (or click on the Share button on the top right of the screen)
* Choose a link template, or make your own using the **Create custom link** button.
* Choose the permissions you would like to assign
* Optionally set a password, link expiration, view limit, or watermarking (see [Link security options](#link-security-options) below).
* Click the **Create link** button on the top right

Now you can copy this link to your clipboard and share it via the button on the right hand side.

The permissions for this link can always be modified later. Changes apply to anyone using that link.

You can also keep track of all of a drive’s shared links via the **Shared Links** section of the drive on the left hand side.

Published links support analytics, so you can review link activity after sharing.

### Link security options

The **Security** section of a link's settings lets you add:

* **Link Expiration**: Choose a date after which the link stops working.
* **Password**: Require recipients to enter a password before they can open the link.
* **View Limit**: Limit how many times the link can be viewed (10, 25, 50, 100, or 500 views, or a custom number). Once the limit is reached, the link stops working.
* **Watermarking**: Overlay a watermark on videos and images shared through the link.
  * **Session-based watermarking** shows the viewer's name and email address. Available on Enterprise plans only.
  * **Text-based Watermarking** lets you enter your own text and choose its position and font size.
  * While watermarking is on, downloads of videos and images are watermarked copies (MP4 for video, JPG for images) instead of the original files.

To stop a link from working without deleting it, use **Disable Link** under **Danger Zone**. You can turn it back on at any time with **Enable Link**, or remove it for good with **Delete Link**.

### Workspace sharing settings

Workspace admins can manage link sharing for the whole workspace from **Settings > Sharing**:

* **Enable link sharing**: Turning this off disables all public links in the workspace and hides link sharing in the Share dialog.
* **Allow custom links**: When off, users can only create links from your link templates, and the **Create custom link** option is hidden. Links created from a template then use that template's permissions.
* **Default to internal comments**: When on, new comments from workspace members default to Internal visibility. Users can still set individual comments to Public.
* **Link templates**: Click **Add Template** to create a new template, or expand an existing one to edit it. For each template you can set the name and icon, permissions, layout, display, thumbnail size, link expiration, **Require password**, view limit, and watermarking. Links created from a template start with its settings, and if **Require password** is on, users are asked to enter a password when they create the link.
* **Lock template**: When locked, only drive managers can change a link's settings after this template has been applied to it.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.shade.inc/sharing-and-collaboration/published-links.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
