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

# Manage users

Add new users to your Oleria workspace, update their roles, and remove access when needed. All user management actions are available to Administrators from the **Manage Users** panel.

## Add a user

<Steps>
  <Step title="Open Manage Users">
    Log into the Oleria workspace. Select your avatar in the upper right corner, then choose **Manage Users** from the dropdown.

    ![Manage Users option in the avatar dropdown menu](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f90a6a7f567df739c9_660459e1d8464f13df8b38eb_Screenshot%25202024-03-27%2520at%252019.39.49.png)
  </Step>

  <Step title="Click Add new user">
    Select **Add new user**.

    ![Add new user button on the Manage Users page](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f90a6a7f567df739cc_66045a46ed6e330f6947a521_Screenshot%25202024-03-27%2520at%252019.42.16.png)
  </Step>

  <Step title="Fill in user details">
    In the **New user** dialog, enter the user's **email address** and select one or more **roles**. All fields are required. Select **View role details** to see what each role can do before you decide. Click **Save**.

    <Note>
      See [Default user roles](/administration/default-user-roles) for the full description and permissions of each role.
    </Note>

    ![New user dialog showing email and role fields](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f90a6a7f567df739f8_66045ad8726da0fa0e3b556e_Screenshot%25202024-03-27%2520at%252019.43.54.png)
  </Step>

  <Step title="Confirm the action status">
    A status notification confirms the action completed successfully.

    ![Action status notification after adding a user](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f80a6a7f567df7397d_65ddb587c86da05e9a7cdd70_mud64LjSmDQbNms3rOOqjFpIfauc_XdFyLHelUk8632lfu-M_vmbBfYtoirwdbXFg-wY-4j9tHDMVEL6oZmRAXxOk8iI7kT2bJ5b50F0jD44HeOZM1lGs5UnCmF_zSGNce0AiP3WQX1a.png)
  </Step>

  <Step title="Verify the new user">
    The new user appears in the user list with an **Active** status and can log in to the workspace using your organization's authentication source.
  </Step>
</Steps>

## Update a user's role

Change the roles assigned to an existing user.

<Steps>
  <Step title="Open Manage Users">
    Log into the Oleria workspace. Select your avatar in the upper right corner, then choose **Manage Users** from the dropdown.
  </Step>

  <Step title="Select the user">
    Click the row for the user whose roles you want to change.
  </Step>

  <Step title="Click Change role">
    Select **Change role**.

    ![Change role button in the user detail panel](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f90a6a7f567df73999_66041146b7f554eb446c6a7f_Screenshot2024-03-27at14.26.29-ezgif.com-censor.png)
  </Step>

  <Step title="Select the roles">
    In the **Assigned roles** list, select one or more roles for the user. This replaces the user's full set of assigned roles, so make sure every role you want them to keep is still selected. See [Default user roles](/administration/default-user-roles) for a description of each role.

    ![Role selection dialog](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f90a6a7f567df73a0f_6604124079941f105be5f64b_Screenshot2024-03-27at14.32.42-ezgif.com-censor.png)
  </Step>

  <Step title="Save the change">
    Click **Save**. A status notification confirms the update. The user list reflects the updated roles.

    ![Action status notification after updating the user role](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f90a6a7f567df7399f_660412803ea159a4855aa9d4_image%2520\(17\).png)
  </Step>
</Steps>

## Remove a user

Revoke a user's access to the Oleria workspace.

<Steps>
  <Step title="Open Manage Users">
    Log into the Oleria workspace. Select your avatar in the upper right corner, then choose **Manage Users** from the dropdown.
  </Step>

  <Step title="Select the user">
    Click the row for the user you want to remove.

    ![User list with the target user row selected](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f90a6a7f567df739cf_65df966c758bbe6ebc6207ca_img-3.png)
  </Step>

  <Step title="Click Delete">
    Select **Delete**.

    ![Delete button in the user detail panel](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f90a6a7f567df739f2_66045d58619ec1f16b852238_Screenshot2024-03-27at19.54.24-ezgif.com-censor.png)
  </Step>

  <Step title="Confirm the removal">
    Click **Yes, remove user** to confirm.

    ![Confirmation dialog for removing the user](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f90a6a7f567df739ee_66045dc8b2ab59b864375dce_Screenshot2024-03-27at19.56.21-ezgif.com-censor.png)
  </Step>

  <Step title="Confirm the action status">
    A status notification confirms the removal. The user no longer appears in the user list.

    ![Action status notification after removing the user](https://cdn.prod.website-files.com/63fc7e99bfef1938067db500/670479f90a6a7f567df739a5_65ddb5871f331856ef201b0b_XjqdPIUw3M0jEc5xjgMj4E88sMOV6POwrFb8imQo4GDIcUulYyuKDmKnJUt8gcK-Peu-J0CrBazSCxAxZTpMkWhFG6y6vr0_kWMP6wLh5jCdV0-cZ_NnjXyyhhRrBK3_NVeTqdyRp3TD.png)
  </Step>
</Steps>

## Contact us

For questions, contact us at [support@oleria.com](mailto:support@oleria.com).