> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/ai-in-umbraco/19.latest/add-ons/copilot-workspace/sharing-conversations.md).

# Sharing Conversations

Share a Copilot Workspace conversation with a colleague as a read-only Snapshot or Live view.

You can share a Copilot Workspace conversation with other backoffice users. The people you share with can read the conversation, but they can't send messages in it or change it.

Sharing is for colleagues in the same Umbraco installation. There is no public link, and each share names one specific user.

## Who Can Share

Any user with access to the Copilot Workspace section can share their own conversations. Only the owner of a conversation can share it, change who it's shared with, or stop sharing it.

The person you share with also needs access to the Copilot Workspace section to open the conversation.

## Sharing a Conversation

1. Open the conversation in Copilot Workspace.
2. In the context panel, find the **Shared with** section.
3. Select **Choose**.
4. Under **Person**, select **Choose a person** and pick one user.
5. Under **Mode**, pick **Snapshot** or **Live**. See [Snapshot and Live Shares](#snapshot-and-live-shares).
6. Select **Share**.

![The Share dialog with a person picked and the Live mode selected](https://23555065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWUtW271qML1SMLKyLBYt%2Fuploads%2Fgit-blob-ae110b9d5028bf05f45b5155ca0b0d0329aa955c%2Fcopilot-workspace-share-dialog.png?alt=media)

The person appears in the **Shared with** section with the mode under their name. To share with more people, repeat the steps for each person.

![The Shared with section in the context panel, listing three people with their share modes and a Choose button](https://23555065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWUtW271qML1SMLKyLBYt%2Fuploads%2Fgit-blob-867e6b64d8ca9960c8abb3ab691eaa6129298ca6%2Fcopilot-workspace-shared-with.png?alt=media)

{% hint style="warning" %}
The person you share with sees everything referenced in the conversation. This includes the contexts and resources in the context panel, and pages or files they might not otherwise have permission to open. The share dialog shows this warning when the conversation has contexts or resources attached.
{% endhint %}

## Snapshot and Live Shares

| Mode         | What the person sees                                                                       |
| ------------ | ------------------------------------------------------------------------------------------ |
| **Snapshot** | The conversation as it is when you share it. Messages you add later stay hidden from them. |
| **Live**     | The whole conversation, including messages you add later.                                  |

You can't share a conversation as a Snapshot before it has any messages.

To change the mode for someone, share the conversation with the same person again and pick the other mode. A new Snapshot share freezes the conversation at its latest messages.

## Seeing What You've Shared

A conversation you've shared shows a small share badge on its icon in the sidebar. Hover over the badge to see the **Shared** label.

![A pinned conversation in the sidebar with the share badge and its Shared tooltip](https://23555065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWUtW271qML1SMLKyLBYt%2Fuploads%2Fgit-blob-5ec35d2a96e54cf8d85d0420ec5dec52d33adf93%2Fcopilot-workspace-shared-badge.png?alt=media)

To see who a conversation is shared with, open it and look at the **Shared with** section in the context panel. The section shows **Not shared with anyone yet.** when it isn't shared.

## Stopping a Share

In the **Shared with** section, select **Remove** next to the person. There is no confirmation step. The person loses access straight away.

Deleting a conversation also removes all of its shares.

## Opening a Conversation Shared With You

Conversations other people share with you appear under **Shared with me** in the Copilot Workspace sidebar. Hover over the badge on a conversation to see who shared it.

![The Shared with me group in the sidebar, with a tooltip naming who shared the conversation](https://23555065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWUtW271qML1SMLKyLBYt%2Fuploads%2Fgit-blob-5b1a4fa349d7ac187cc42d7f236e5a62a350b377%2Fcopilot-workspace-shared-with-me.png?alt=media)

When you open a shared conversation:

* A notice replaces the message box: "This conversation is read-only — shared by" followed by the owner's name.
* The context panel shows the conversation's contexts and resources, but you can't change them.
* Shared conversations have no **Pin**, **Rename**, **Move to project...**, **Archive**, or **Delete** actions.

![A shared conversation opened by the recipient, with the read-only notice in place of the message box](https://23555065-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWUtW271qML1SMLKyLBYt%2Fuploads%2Fgit-blob-c9459061541c2e41e8ace3ebd565c089ddc72fb2%2Fcopilot-workspace-shared-read-only.png?alt=media)

## Email Notification

The first time you share a conversation with someone, Umbraco sends them an email. The email names you, gives the conversation's title, and links to the conversation in the backoffice. Changing the mode for someone already on the list doesn't send another email.

The email uses the site's normal SMTP settings. If SMTP isn't configured, or the user has no email address, the share still works but no email is sent. See [SMTP settings](https://docs.umbraco.com/umbraco-cms/develop-with-umbraco/configuration/globalsettings#smtp-settings) for how to configure email.

## Related

* [Using Copilot Workspace](/ai-in-umbraco/19.latest/add-ons/copilot-workspace/copilot-workspace.md) - Conversations, projects, and the context panel
* [AI Contexts](/ai-in-umbraco/19.latest/concepts/contexts.md) - Brand voice and guidelines


---

# 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://docs.umbraco.com/ai-in-umbraco/19.latest/add-ons/copilot-workspace/sharing-conversations.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.
