Members and groups

📘

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.

Permission settings

You may set permission levels for each user in one of three ways:

📘

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".

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.

Add a member

Follow these steps to add one or more new members to your organization.

1. Navigate to the Members tab under workspace settings and click Add Members.

2. Enter the email address of the new member.

3. 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.

1. Navigate to the Members tab under workspace settings and click Manage groups

2. In the new module, click + Add at the bottom of the list

3. 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

4. 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:

1. Navigate to the Members tab under workspace settings and click Manage groups

2. Click on the group you want to add the member to

3. In the section for members, look up your member and add them to the group.

4. Click save.

The second way to add a member to a group is from their member detail page:

1. Navigate to the Members tab under workspace settings, find your member in the list, and hit edit to open their member details page

2. In their member profile, you can select the checkbox for the group you want to add them to in the Groups section.

3. Click save.

Complete tutorial in Python SDK