# Users and roles

> Each member of a Safecube workspace has one of four roles, Owner, Admin, Editor or Viewer, and an access scope, All or Teams, that together decide which shipments they see and what they can change.

A Safecube workspace is shared by its members. Each member has a **role**, which sets what they can do, and an **access scope**, which sets which shipments they see. Admins and Owners manage the members in Settings > **Users**.

## Who can manage users

Only an Admin or an Owner can open the **Users** page, invite a user, change a role or delete a user. An Editor or a Viewer does not see **Users** under **Workspace Settings**: a link to `/settings?page=users` opens **My Account** for them.

An Admin cannot act on an Owner: the row of an Owner has no menu for them, and the **Owner** role is offered to an Owner only.

## Roles

The four roles are hierarchical: Viewer, Editor, Admin, Owner. Each role has every right of the roles below it.

| Gesture | Viewer | Editor | Admin | Owner |
| ------- | :----: | :----: | :---: | :---: |
| View shipments, their details, alerts and documents | ✓ | ✓ | ✓ | ✓ |
| Export shipments to CSV, share a shipment | ✓ | ✓ | ✓ | ✓ |
| Preview, download and share [documents](/en/platform/workspace/documents) | ✓ | ✓ | ✓ | ✓ |
| Create, edit and archive shipments, add them to teams | — | ✓ | ✓ | ✓ |
| Upload, edit and replace documents | — | ✓ | ✓ | ✓ |
| Delete a shipment or a document permanently | — | — | ✓ | ✓ |
| Open the **Workspace Settings** pages: **General**, **Alerts**, **Users**, **Teams**, **Monitoring**, **Customize table** | — | — | ✓ | ✓ |
| Invite, edit and delete users, manage teams | — | — | ✓ | ✓ |
| Open **Developers**: API key and webhooks | — | — | ✓ | ✓ |
| Act on an Owner, give the Owner role | — | — | — | ✓ |
| [Delete the workspace](/en/platform/workspace/workspace-settings), change its [custom URL](/en/platform/workspace/white-label) | — | — | — | ✓ |

Every role keeps access to its [personal settings](/en/platform/workspace/account-settings): **My Account**, **My preferences** and **My notifications**.

The **Role Permissions** tab of the Users page gives a read-only overview of the roles, marked "Read-only — contact support to modify". The rights of a role cannot be changed from the app.

## Access scope

The scope applies to Editors and Viewers. Admins and Owners always have the scope **All**, with the tooltip "Admin and Owner roles always have full access".

| Scope | What the member sees |
| ----- | -------------------- |
| **All** | Every shipment of the workspace, whatever its teams |
| **Teams** | Only the shipments of the teams the member belongs to, with their documents and alerts. A shipment in no team is not visible |

On the shipments they see, members keep the rights of their role: an Editor with the scope **Teams** can edit the shipments of their teams.

A member with the scope **Teams** and no team sees no data. Their row shows the badge **No access**, "This user cannot see any data — assign at least one team to unlock access". Teams are described in [Teams](/en/platform/workspace/teams).

## Open the Users page

1. Select **Settings** at the bottom of the sidebar.
2. Under **Workspace Settings**, select **Users**.

The page, **Users management**, opens on the **Members** tab, which shows the number of members. A link to `/settings?page=users` opens it too.

| Column | Content |
| ------ | ------- |
| **User Name** | Name and email of the member |
| **Role** | Owner, Admin, Editor or Viewer |
| **Scope** | All or Teams |
| **Teams** | Number of teams, for a member with the scope Teams |
| **Date added** | Date the member joined the workspace |

Every column can be sorted. **Search members** finds a member by first name, last name or email, and **All roles** filters the list on one role. The list shows 10 members per page by default.

![Users management page on the Members tab, with the search, the All roles filter and seven members with their role, scope and teams](https://docs.safecube.ai/media/images/shared/settings-users--members.webp?v=84d2c95e)

## Invite a user

1. Open the **Users** page and select **Add user**. You can also open **More options** in the top bar and select the quick action **Invite members**.
2. In **Email**, enter the email address of the person.
3. In **Role**, choose a role. No role is selected by default.
4. For an Editor or a Viewer, choose a **Scope**: **All**, the default, or **Teams**. With **Teams**, choose one or more teams in **Access teams**.
5. Select **Add user**.

![Add user dialog with the Email field and the empty Role list](https://docs.safecube.ai/media/images/shared/modal-user-create--default.webp?v=b8308801)

With the scope **Teams**, the dialog reads "This user will only be able to see shipments from the teams they are assigned to.".

![Add user dialog with the Viewer role, the Teams scope and one team chosen in Access teams](https://docs.safecube.ai/media/images/shared/modal-user-create--scope-teams.webp?v=0ea3aedd)

Safecube displays "User created successfully." and the member appears in the list at once. If the email address has no Safecube account yet, the person receives an email to create a password. If it already has an account, no email is sent: tell the person they have been added to the workspace.

If the invitation fails, Safecube displays an error message and the dialog shows **Retry**.

## Change the role, scope or teams of a user

From the list, select the role, the scope or the number of teams of a member to change it in place. The tooltips read "Change role", "Change scope" and "Change teams". The scope can be changed for an Editor or a Viewer only, and the teams for a member with the scope **Teams** only.

![Role selector open on the row of an Editor in the Members tab](https://docs.safecube.ai/media/images/shared/settings-users--role-edit.webp?v=2c0dfe0c)

You can also use the dialog:

1. Open **More options** at the end of the row, then **Edit user**.
2. In **Update user role**, change **Role**, **Scope** or **Access teams**.
3. Select **Update user**.

Safecube displays "User role updated successfully.". Giving the role Admin or Owner sets the scope to **All** and removes the member from their teams.

![Update user role dialog for an Editor with the Teams scope and two teams in Access teams](https://docs.safecube.ai/media/images/shared/modal-user-update--scope-teams.webp?v=7eedb2e3)

## Delete a user

1. Open **More options** at the end of the row, then **Delete**.
2. In **Delete user**, check the name of the member. The action cannot be undone.
3. Select **Delete**.

Safecube displays "User deleted successfully." and the member loses access to the workspace.

## Limits

- The four roles are fixed: no role can be created, and the rights of a role cannot be changed.
- Admins and Owners cannot be restricted to teams, and cannot be members of a team.
- The list shows no invitation status: an invited user is listed as a member as soon as the invitation is created.
- An Admin cannot edit or delete an Owner, nor give the Owner role.
