# Share a secret or secret item

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

* Workspace **Owners**, **Super Admins**, **Admins**, **Users**, and **Guest Users**
* Secret and secret item **Owners**
* Supported using the Cerby web app and mobile app
  {% endhint %}

As a secret or secret item (such as WiFi, SSH keys, database, server, and custom item) **Owner**, you can share your items with other workspace members and teams using the following Cerby client apps:

* [Cerby web app](#cerby-web-app)
* [Cerby mobile app](#cerby-mobile-app)

The following sections describe the sharing process using each client app.

***

## Cerby web app

To share a secret or secret item, you must complete the following steps using the Cerby web app:

1. Log in to your corresponding [Cerby](https://app.cerby.com/) workspace.
2. Select the **Secrets** option from the left navigation drawer. The **Secrets** view is displayed.
3. Click the **Share secret** (<img src="/files/4runQExN0JaqK8hNIxwl" alt="" data-size="line">) icon of the corresponding secret card. A drop-down list is displayed.
4. Select the **Share item** option. Depending on whether you have an identity challenge configured, one of the following scenarios occurs:
   * The **Confirm your identity to continue** dialog box is displayed. To confirm your identity, use one of [Cerby's multi-factor authentication methods](https://help.cerby.com/tips-and-troubleshooting/best-practices/set-up-your-identity-with-cerby-s-mfa-methods).
   * The **Share secret** dialog box is displayed when you don’t have an identity challenge configured.
5. 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.
6. Select the corresponding member or team from the list. The member or team is displayed in the **Members and Teams** section.
7. Repeat steps 5 and 6 as necessary to select multiple members or teams.
8. Select the corresponding role on the secret from the **Role** drop-down list:

   * **Owner:** They can share access, edit, add attachments, and manage the secret settings.
   * **Collaborator:** They can only view the secret and download the attachments.

   **NOTE:** When you select a member with the **Login-only** role, they are listed in the **Login-Only** section. You can only select the **Collaborator** role for them.
9. Customize the message to send when you share the collection in the **Message** field.
10. Click the **Share** button. The dialog box closes, and a success message box is displayed.

Now you are done.

***

## Cerby mobile app

To share a secret or secret item, you must complete the following steps using the Cerby mobile app:

1. Open the Cerby mobile app.
2. Log in to your Cerby workspace.
3. Activate the **Secrets** tab located at the top of the screen. All your saved and shared secrets and secret items are displayed.
4. Tap the corresponding secret card. The secret details screen is displayed.

**NOTE:** If you have an identity challenge configured, the Cerby mobile app confirms your identity automatically.

5. Tap the **Share** (<img src="/files/XBjFAD7YbG7VRpvexGTI" alt="" data-size="line">) icon on Android or the **Share** (<img src="/files/Vmm6jXxjFIvDG22GhDW1" alt="" data-size="line">) icon on iOS located at the top right of the screen. The **Share item** screen 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 corresponding member or team from the list. The member or team is displayed in the **Members and Teams** section.
8. Repeat steps 6 and 7 as necessary to select multiple members or teams.
9. Select the role to assign to the members and teams from the drop-down list:

   * **Owner:** Members and team can share access, edit, add attachments, and manage the secret settings.
   * **Collaborator:** Members and teams can only view the secret and download the attachments.

   **NOTE:** When you select a member with the **Login-only** role, they are listed in the **Login-Only** section, and you can only select the **Collaborator** role for them.
10. Customize the message to send when you share the collection in the **Message** field.
11. Tap the **Share item** button on Android or the **Share** button on iOS. The screen closes, and the users with shared access are displayed in the **Members** section of the secret details screen.

Now you are done.

***

## Share a secret or secret item with external users via a link

To share access to a secret or secret item with external users via a link, follow the instructions in the article [How to share items with external users via a link](/cerby-web-app/accounts/managing-access-to-your-accounts/share-items-with-external-users-via-a-link.md).


---

# 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/secrets/managing-access-to-your-secrets/share-a-secret-or-secret-item.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.