# Update a user's role on 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 the Cerby mobile app
  {% endhint %}

As a secret or secret item (such as WiFi, SSH keys, database, server, and custom item) **Owner**, you can update the role of other workspace members on your items using the Cerby web app. To do so, you must complete the following steps:

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 **Settings** (<img src="/files/eZ61KyoQvtgZW3FGcS0V" alt="" data-size="line">) icon of the corresponding secret card. The secret details page is displayed with the **Settings** tab activated.\
   **NOTE:** If an identity challenge is configured, the **Confirm your identity to continue** dialog box is displayed, and a push notification is sent to your Cerby mobile app:
4. Confirm your identity by tapping the **It’s me!** button from the **Confirmation Request** screen of your Cerby mobile app. The **Confirm your identity to continue** dialog box closes in the Cerby web app, and the secret details page is displayed with the **Settings** tab activated.
5. Activate the **Members** tab. The **User Overview** section is displayed with a table of users who have shared access to the secret or secret item.
6. Select the option from the **Cerby role** drop-down list that corresponds to the new role on the secret or secret item:

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

   **IMPORTANT:** Users who have received shared access to the same secret or secret item multiple times appear with the **Mixed role** status in the **Cerby role** column. When clicking the drop-down list, the **Share secret** dialog box is displayed with each access grant and role. You can only update the role if shared access is via a direct grant to the secret or a collection to which you have the **Owner** role.

A success message box is displayed.

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/secrets/managing-access-to-your-secrets/update-a-user-s-role-on-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.