> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oleria.com/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 their **role**. All fields are required. Click **Save**.

    ![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 role 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 role 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 new role">
    In the dialog, select the new role for the user. 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 new role.

    ![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).