# Share a collection

{% hint style="info" %}
**Who can use this feature?**

* Workspace **Owners**, **Super Admins**, **Admins**, **Users**, and **Guest Users**
* Collection **Owners**
* Supported using the Cerby web app and mobile app. For the mobile app instructions, read the article [Share a collection using the Cerby mobile app](https://help.cerby.com/cerby-mobile-app/collections/managing-access-to-your-collections/share-a-collection)
  {% endhint %}

As a collection **Owner**, you can share a collection with other workspace members and teams and select the role to assign to them on the collection. With this action, you extend access to all the items within the collection.

The following rules are applied to items, subcollections, members, and teams when sharing a collection:

* The role you select on the collection (**Owner** or **Collaborator**) is the same role that other members and teams will have on all the accounts, secrets, business hubs, and assets within the collection.
* When your collection has subcollections, you are also sharing access to all nested subcollections and their items, inheriting the permission settings bottom-down.
* When your collection already has business hub integrations and assets within, Cerby sends the corresponding emails for users to claim access to the integration. For more information, read the article [Manage access to business hubs and assets with collections](https://help.cerby.com/setup-and-admin/identity-lifecycle-management-idlcm/business-hubs/managing-your-integrations/manage-access-to-business-hubs-and-assets-with-collections).
* Members with the **Login-only** and **Guest user** workspace roles can only be granted the **Collaborator** role on a collection.

To share a collection, you must complete the following steps using the Cerby web app:

1. Log in to your [Cerby](https://app.cerby.com/) workspace.
2. Select the **Collections** option from the left menu. The **Collections** page is displayed.
3. Click the **Share** icon that appears when hovering over the corresponding collection card. The **Share Access** dialog box is displayed. ​**TIP:** You can also open the **Share Access** dialog box by performing the following actions:
4. Click the **Settings** (<img src="/files/fd5pH4uE4CXlx41dQNT1" alt="" data-size="line">) icon of the corresponding collection card. The collection details page is displayed with the **General** tab activated.
5. Click the **Share** button located at the top right of the page. The **Share Access** dialog box is displayed.
6. Enter the name of the member or team in the search bar. The members or teams that match the name are displayed on a list automatically.
7. Select the member or team from the list to add them to the **Members and Teams** section.
8. Repeat steps 4 and 5 as necessary.
9. Select the role to assign to the members and teams on the collection from the **Access** drop-down menu:

   * **Owner:** Members and teams can share access to the collection, manage the item settings, and perform the actions of a **Collaborator**.
   * **Collaborator:** Members and teams can only log in to the accounts, view the secrets, and download the secret attachments.

   **NOTE:** When you select a member with the **Login-only** or **Guest User** role, you can only select the **Collaborator** role for them.
10. (Optional) Customize the message to send when you share the collection in the **Message** field.
11. Click the **Share** button. The wizard closes, and a success message box is displayed.

{% hint style="info" %}
**NOTE:** When you share a collection containing business hubs and assets, Cerby sends emails for users to claim access to the integration. After users claim access, Cerby adds these users to the external apps. For more information, read the article [Manage access to business hubs and assets with collections](https://help.cerby.com/setup-and-admin/identity-lifecycle-management-idlcm/business-hubs/managing-your-integrations/manage-access-to-business-hubs-and-assets-with-collections).
{% endhint %}

Now you are done.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.cerby.com/cerby-web-app/collections/managing-access-to-your-collections/share-a-collection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.