Members and groups
User roles for org-level and project level. Also, how to add or update a member.
Access to groups
Groups is a feature only available for our pro and enterprise license tiers. For more information, please reach out to your Labelbox representative.
Organizations, groups & members
When you sign up for a Labelbox account, Labelbox will assign you an organization. Each organization is made of members with different permissions. Additionally, members can belong to groups. A group is defined as a set of members that share the same project assignments and can be managed together as a single unit rather than individually.
Admins can invite additional members to join the organization. Admins can also control how members access certain projects by configuring member roles.
You can specify a member role to limit a member to a certain project or restrict a member to certain actions. And if you wish to add an external workforce, you can limit their access to a specific project; so they won’t be able to view other projects, datasets, or ontologies created by your organization.

Example of a member's detail page from Workspace settings > Members
Permission settings
You may set permission levels for each user in one of three ways:
Permission setting | Definition |
---|---|
Organization-wide (or workspace wide) | The member will have access to all projects with their default role. This can not be overridden on the project level |
Project-based using Groups | The member will have access to all projects that the Group is assigned to. They will inherit their role from the "Default role" in their user profile. |
Project-based using manual assignment | The member can be manually assigned to specific projects. In this case, the admin can specify their user role or they will inherit their role from their user profile. |
Note
Organization-wide and Project-based roles are designed to be mutually exclusive.
Organization-wide or workspace-wide roles
A role assigned at this level will apply to all projects within your organization or workspace if you have multiple workspaces configured. Users cannot be restricted from accessing certain projects at the organization level. If set, the user's project-based roles cannot be modified.
To apply this level of role to the member, you must select the option in the user's profile for "Use this role for all projects".
Permission | Admin | Read-only Admin | Data Admin | Team Manager | Reviewer | Labeler |
---|---|---|---|---|---|---|
View datasets in Catalog | ✓ | ✓ | ✓ | |||
Import data/create new datasets in Catalog | ✓ | ✓ | ||||
Apply filters in Catalog | ✓ | ✓ | ✓ | |||
Create slices in Catalog | ✓ | ✓ | ||||
Attach a dataset to a project | ✓ | |||||
Detach a dataset from a project | ✓ | |||||
Create new batches | ✓ | |||||
Rename a batch | ✓ | |||||
Delete batches | ✓ | |||||
Remove queued labels from a batch | ✓ | |||||
Delete non-queued labels from a batch | ✓ | |||||
Create/modify ontologies | ✓ | |||||
Create/modify/delete projects | ✓ | |||||
Invite new members to an organization | ✓ | |||||
View projects and labels | ✓ | ✓ | ✓ | ✓ | ✓ (own only) | |
Add/modify members on a project | ✓ | ✓ | ||||
Create/modify labels | ✓ | ✓ | ✓ | ✓ (own only) | ||
Review labels | ✓ | ✓ | ✓ | |||
Receive benchmark labels | ✓ | ✓ | ✓ | ✓ | ||
Delete labels | ✓ | ✓ | ✓ | |||
View own & team's performance metrics | ✓ | ✓ | ✓ | ✓ (own only) | ✓ (own only) | |
Create/update/delete/ resolve/reopen issues | Issues & comments set at project-level | |||||
Create/update/delete comments | Issues & comments set at project-level | |||||
Create an export | ✓ | |||||
Models - full access | ✓ | |||||
View Models | ✓ | ✓ |
Project-based roles (via Groups or manual assignment)
Roles at this level are assigned on a project-by-project basis. Contains an additional "No access" permission setting to restrict a user from selected projects. If set, the user's organization role cannot be modified.
Project-based roles can be assigned either via the groups feature or via manual assignment.
Permission | Project-based project lead | Project-based team manager | Project-based reviewer | Project-based labeler |
---|---|---|---|---|
Import data/create new datasets | ||||
Create new batches | ✓ | |||
Rename a batch | ✓ | |||
Delete batches | ✓ | |||
Remove queued labels from a batch | ✓ | |||
Delete non-queued labels from a batch | ✓ | |||
Attach a dataset to a project | ✓ | |||
Detach a dataset from a project | ✓ | |||
Edit/delete projects | ✓ | |||
Invite new members to an organization | ||||
Add/modify existing org members on a project | ✓ | ✓ | ||
Create/modify labels | ✓ | ✓ | ✓ | ✓ (own only) |
Review labels | ✓ | ✓ | ✓ | |
Receive benchmark labels | ✓ | ✓ | ✓ | ✓ |
Delete labels | ✓ | ✓ | ✓ | |
View own & team's performance metrics | ✓ | ✓ | ✓ (own only) | ✓ (own only) |
Create an export | ✓ | |||
Create issues | ✓ | ✓ | ✓ | ✓ (on own assets only) |
Update/delete issues | ✓ (own only) | ✓ (own only) | ✓ (own only) | ✓ (on own assets only) |
Resolve/Reopen issues | ✓ | ✓ | ✓ | ✓ (own only) |
Create/update/delete comments | ✓ | ✓ | ✓ | ✓ (on own assets only) |
Add a member
Follow these steps to add one or more new members to your organization.
-
Navigate to the Members tab under workspace settings and click Add Members.
-
Enter the email address of the new member.
-
Assign an organization or project-based role for the member. For a detailed description of organization roles vs. project-based roles, see the sections above.
a. When you set a role for a member at the organization level, the user will have access to all projects within the organization as that role.
b. When you set a role for a member at the project level, you may set the member's permissions for specific projects. Members assigned project-based roles will only have access to projects to which they are specifically assigned a role.
New members will receive an email invitation to join Labelbox. Until a new user accepts the invitation and signs into Labelbox, their name will appear under Invites Pending in the Members tab. You have the option to resend or revoke pending invitations.
If you add a member to a project and that user already exists in your organization, they will not receive an email. They will just be added to the project.
If you add a member that is already part of another organization, that member will lose all access to the former organization if they choose to accept the invitation to your organization.
Change member role
After you have added your members, you can change their roles or manage the projects they access. To do this, navigate to the Workspace setting > Members and click on the member you want to update. Only admins can modify a member.
You can also modify a member's project-based role by selecting a project, going to the Settings tab, and clicking on the Members section.
Remove a member
To remove a team member, go to the Members tab, click the three dots next to the member's email, click on Remove and click on Confirm. Only admins may remove a member from an organization or project.
Create a group
Follow these steps to add one or more new members to your organization.
-
Navigate to the Members tab under workspace settings and click Manage groups
-
In the new module, click + Add at the bottom of the list
-
This will take you to the new group creation wizard. To create a new group, you will need to provide the following information:
- Group name
- Group color
- List of projects the group should be assigned to
- List of members that should belong to the group
-
Click Save at the bottom of the wizard to create a new group!
Add members to an existing group
There are two ways to add a member to an existing group. Keep in mind, adding a member to a group will automatically add them to all the projects assigned to the group.
The first way to add a member to a group is from the Manage groups module:
-
Navigate to the Members tab under workspace settings and click Manage groups
-
Click on the group you want to add the member to
-
In the section for members, look up your member and add them to the group.
-
Click save.
The second way to add a member to a group is from their member detail page:
-
Navigate to the Members tab under workspace settings, find your member in the list, and hit edit to open their member details page
-
In their member profile, you can select the checkbox for the group you want to add them to in the Groups section.
-
Click save.
Complete tutorial in Python SDK
Updated 7 days ago