# Chat sharing

Chat sharing lets you give other users or groups read-only access to a Coder Agents conversation.

## Share a chat [#share-a-chat]

1. Open the chat you want to share on the **Agents** page.
   Only top-level chats can be shared; sub-agent chats inherit sharing from their parent.
2. Select the share icon in the chat top bar.
3. Select the **Search for user or group** field.
4. Search for and select a user or group.
5. Select **Add member** to grant **Read** access.
6. If you shared with a group, copy the chat URL from your browser and send it to the group members.

Coder does not create a separate share link.
Users you share with directly receive a **Chat Shared** notification with a link to open the chat.
Members who gain access only through a group are not notified.

## Shared chat access [#shared-chat-access]

Viewers can open the chat from a direct link, view messages, stream live updates, and download chat attachments.
Chats shared by other users can appear in the sidebar under **Shared with you** when they are in the chat list.
Pinned shared chats appear under **Pinned**.
Viewers reach sub-agent chats by following sub-agent links inside the parent chat or by opening a direct URL.

Viewers have read-only access: they cannot send or edit messages, regenerate the chat title, archive the chat, or change its sharing settings.

## Disable chat sharing [#disable-chat-sharing]

Administrators can disable chat sharing for a deployment with `--disable-chat-sharing`, `CODER_DISABLE_CHAT_SHARING`, or `disableChatSharing`.
The flag also turns off chat project sharing.
While it is set, existing shares are ignored, new shares are rejected, and only creators and administrators can access chats and chat projects.