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

# Visibility and Sharing

> Choose who can use an assistant and understand who can edit it

Every assistant has a visibility that decides who can use it. You set it in the **Access** section of the assistant editor. Shared assistants are the easiest way to give a whole team the same instructions, files and tools.

## Visibility options

| Option | Shown as | Who can use it |
| - | - | - |
| **Private** | Only you | Only you |
| **Team** | A specific team | All members of the team |
| **Workspace** | All workspace members | All members of the workspace and its teams |
| **Organization** | Entire organization | Every member of the organization |

New assistants are **Private**.

## Share an assistant

1. Open the assistant in **Assistant Studio** and click **Edit**.
2. Under **Access**, choose **Team**, **Workspace** or **Organization**.
3. Pick the team, workspace or organization from the list.
4. Click **Update**.

You can only share with a scope where you are a **Manager** or **Owner**. Roles are inherited: a Manager of a workspace can also share with that workspace's teams. If you aren't a Manager or Owner anywhere, the **Access** section doesn't appear and your assistants stay private.

To stop sharing, set **Access** back to **Private**.

## Who can edit

| Assistant | Who can edit, delete and manage files |
| - | - |
| Private | Only the creator |
| Shared with a team, workspace or organization | The creator, and Managers or Owners of that scope |

Viewers of a shared assistant can use it but not change it. They see **View** instead of **Edit** in Assistant Studio and a read-only editor. To adapt it, they can click **Duplicate** to get a private copy.

The creator always keeps full access to their own assistant, whatever its visibility.

## What sharing includes

When you share an assistant, everyone who can use it gets:

* Its instructions and recommended model.
* Its knowledge files, as context in their chats.
* Its conversation starters, even when the underlying prompt template is shared more narrowly. The editor warns you before this happens.

Some parts depend on each user:

* **Toolset**: tools only work for people who can use the toolset, and each person must connect their own accounts. See [Tools and toolsets](https://docs.blackmountain.io/assistants/tools-and-toolsets.md).
* **Skills**: a team assistant can only use skills shared with that team, and workspace and organization assistants can't use skills.

> [!WARNING]
>
> Knowledge files and instructions in a shared assistant reach everyone who uses it. Don't put information there that not all of them should see.

## Shared chats

When you share a chat that uses an assistant, other members only get the assistant on their messages if they could use it themselves. A private assistant is never lent to someone else. Their messages run without it instead.

## Related

> [card] [Organizations, workspaces and teams](https://docs.blackmountain.io/get-started/organizations-workspaces-teams.md)
>
> How the hierarchy works.

> [card] [Roles and permissions](https://docs.blackmountain.io/admin/organization/roles-and-permissions.md)
>
> What Owners, Managers and Viewers can do.

> [card] [Assistant governance](https://docs.blackmountain.io/admin/assistants-skills/governance.md)
>
> Manage assistants across your organization.

> [card] [Sharing chats](https://docs.blackmountain.io/chat/sharing.md)
>
> Work on a chat together.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.