Skip to content
Documentation sections

Users and roles

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.

GestureViewerEditorAdminOwner
View shipments, their details, alerts and documents✓✓✓✓
Export shipments to CSV, share a shipment✓✓✓✓
Preview, download and share 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, change its custom URL———✓

Every role keeps access to its personal 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".

ScopeWhat the member sees
AllEvery shipment of the workspace, whatever its teams
TeamsOnly 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.

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.

ColumnContent
User NameName and email of the member
RoleOwner, Admin, Editor or Viewer
ScopeAll or Teams
TeamsNumber of teams, for a member with the scope Teams
Date addedDate 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.

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.

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

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.

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.

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.