# Shareable Links (https://www.librechat.ai/docs/features/shareable_links)

Shareable links let you publish a read-only branch of a conversation that others can open through a generated URL or QR code. Recipients see the published messages, branches, and artifacts without changing the original. Signed-in recipients can continue from the visible branch as a personal copy.

## Key Features

- **Easy sharing**: Generate a link in a couple of clicks.
- **QR codes**: Open the conversation on a phone by scanning a code.
- **Branching**: Shared links keep every branch of the conversation.
- **Artifacts**: React components, HTML previews, and Mermaid diagrams stay interactive.
- **File snapshots**: Referenced conversation files can be previewed or downloaded from the shared link without granting recipients access to the owner's live file ACL.
- **Continue as a copy**: Signed-in viewers can copy the visible branch into their own conversation history and continue chatting.
- **Recipient preferences**: Viewers can switch language and theme.
- **Stable updates**: Publish newer turns and the current file choice without changing the URL.
- **Shared badges**: Active links are marked in the conversation list and chat header.
- **Link management**: One dashboard to review or revoke every link you've created.

## Share a Conversation

You can start sharing from two places.

<Steps>
<Step>

**From the conversation menu.** Open the menu next to a conversation in the sidebar and choose the share option.

![Share option in the conversation menu](/images/shared-links/share-from-menu.png)

</Step>
<Step>

**From the share button.** Inside an active conversation, use the dedicated share button in the header.

![Share button in an active conversation](/images/shared-links/share-button.png)

</Step>
</Steps>

## Share Link Options

Creating a link opens a modal where you control how the conversation appears to recipients.

![Create share link modal](/images/shared-links/share-modal-create.png)

![Share link modal with management options](/images/shared-links/share-modal-options.png)

Once a link exists, the modal offers these actions:

- **Update link**: Republish the latest messages through the selected branch tail and the current file-sharing choice while keeping the same URL.
- **Generate QR code**: Create a QR code for mobile access.
- **Copy link to clipboard**: Copy the shareable URL.
- **Delete link**: Remove the link and revoke access for anyone who has it.

When file snapshots are enabled, users can choose whether the link includes files referenced in the published messages. The selected files are pinned to that share revision and served through share-specific routes without granting access to the owner's live file ACL. Updating the link replaces the pinned set and file-sharing choice; stable file URLs revalidate so a removed or replaced snapshot is not served from an older browser cache.

Publication is tied to the selected branch's exact persisted tail. If its newest message is still being saved, LibreChat retries once without switching to another branch. If the tail is still unavailable, or the conversation has no persisted messages yet, the modal shows a specific error so you can wait and retry. An unavailable shared-link view also offers **Retry** to refetch the same URL.

## QR Codes

Generate a QR code for any shared conversation, then scan it with a phone camera to open the link. The code points to the same shared URL.

![QR code generated for a shared link](/images/shared-links/qr-code.png)

![QR code download options](/images/shared-links/qr-code-download.png)

QR codes are handy for presentations, quick mobile access, printed handouts, and conference demos.

## Viewing Shared Conversations

When someone opens your link, they see a focused, read-only view of the published branch, including its date, messages, and artifacts.

![A shared conversation as a recipient sees it](/images/shared-links/shared-view.png)

## Continue a Shared Conversation

An authenticated viewer can select **Continue this chat** to create a personal conversation from the branch currently shown. LibreChat copies only the direct path to the active message, including eligible snapshotted file references, and opens the new conversation under the viewer's account.

Continuing never changes the shared snapshot or the owner's conversation. Public viewers must sign in before LibreChat can create their copy.

The copy request is tied to the share revision the viewer loaded. If the owner updates the same link before the viewer continues, LibreChat reloads the current revision and asks the viewer to retry instead of copying message positions from stale content.

## Branching

Shared links preserve conversation branches, so recipients can follow the different paths the discussion took. Use the branch navigation arrows to move between them.

![Branch navigation menu in a shared conversation](/images/shared-links/branching-menu.png)

![Navigating branches in a shared conversation](/images/shared-links/branching-support.png)

This is useful for showing how different prompts lead to different AI responses, or how a single problem can be approached several ways.

## Artifacts

Artifacts generated during the conversation stay fully functional in shared links.

![Interactive artifacts in a shared conversation](/images/shared-links/artifacts-support.png)

Recipients can:

- View interactive React components.
- See HTML previews.
- Examine Mermaid diagrams.
- Read the underlying code and the context it was generated in.

## Recipient Preferences

Viewers can adjust the interface to their own preferences without affecting your settings.

![Language and theme settings on a shared link](/images/shared-links/recipient-settings.png)

- **Theme**: Light, dark, or system.
- **Language**: View the interface in their preferred language.

## Managing Your Shared Links

Open the Shared Links dashboard under **Settings → Data Controls** to review every conversation you've shared.

![Shared links management dashboard](/images/shared-links/management-modal.png)

![Details and options for an individual shared link](/images/shared-links/management-details.png)

From the dashboard you can:

- **View all links**: See every conversation you've shared.
- **Search and filter**: Find a specific shared link and preview its content.
- **Revoke access**: Delete a link to stop sharing immediately.

Conversations with an active shared link also show a link badge in the sidebar, and the chat header's share control shows the same active state.

## Configuration

Three environment variables in your `.env` file control the feature:

- **`ALLOW_SHARED_LINKS`** (default: `true`): Enables the shared links feature. Set to `false` to stop users from creating links.
- **`ALLOW_SHARED_LINKS_PUBLIC`** (default: `false`): Controls whether links open without authentication. By default, recipients must be logged in. Set to `true` to allow public, unauthenticated access.
- **`SHARED_LINKS_SNAPSHOT_FILES`** (default: `true`): Controls whether shared links can include referenced conversation files. This environment variable overrides [`interface.sharedLinks.snapshotFiles`](/docs/configuration/librechat_yaml/object_structure/interface#sharedlinks) when set.

```bash title=".env"
# Enable shared links (default)
ALLOW_SHARED_LINKS=true

# Require authentication to view shared links (default)
ALLOW_SHARED_LINKS_PUBLIC=false

# Include referenced files in shared-link snapshots (default)
SHARED_LINKS_SNAPSHOT_FILES=true
```

Role permissions decide which users can create links, share them with authenticated users, or make them visible to everyone on the instance:

```yaml title="librechat.yaml"
interface:
  sharedLinks:
    create: true
    share: true
    public: false
    snapshotFiles: true
```

`sharedLinks.public` controls whether a user can toggle "share with everyone." `ALLOW_SHARED_LINKS_PUBLIC` still decides whether those public links are viewable without logging in. `sharedLinks.snapshotFiles` controls the default file-snapshot behavior from YAML, and `SHARED_LINKS_SNAPSHOT_FILES` can override or disable it globally.

<Callout type="info">
For the full environment variable reference, see the [.env Configuration](/docs/configuration/dotenv#shared-links) page.
</Callout>

## Frequently Asked Questions

<Accordions type="single" collapsible>
<Accordion title="Can recipients respond to shared conversations?">

The shared snapshot remains read-only. Signed-in recipients can select **Continue this chat** to create a personal copy and interact with the AI there.

</Accordion>
<Accordion title="What happens if I delete a conversation after sharing it?">

The link stops working. Anyone who navigates to it sees a "Shared link not found" page.

</Accordion>
<Accordion title="Can I edit a conversation after sharing it?">

Yes. Edits to messages already included in the link appear in the shared view. New turns outside the published branch tail appear only after you select **Update link**; the URL stays the same.

</Accordion>
<Accordion title="Do shared links work offline?">

No. Recipients need an internet connection to view shared conversations.

</Accordion>
</Accordions>
