> ## Documentation Index
> Fetch the complete documentation index at: https://docs.labelbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage members and groups

> Instructions for managing members and groups permissions.

A key part of managing any labeling operation is controlling who has access to what. Labelbox gives you powerful, flexible tools to manage your team, whether you have a small group of labelers or a large, multi-team organization. This guide explains the core concepts of members and groups and provides step-by-step instructions for managing them.

## Key concepts

Before diving into the "how-to," it's important to understand the two main components of team management in Labelbox:

* A ***member*** is any individual user account with access to your Labelbox organization. Every person you invite to Labelbox is a "member." You can assign roles and project access to members one by one. This is great for small teams or for users who need unique permissions.
* A ***group*** is a collection of members that you can manage as a single unit. Instead of assigning projects and roles to each person individually, you can assign them to a group. Everyone in that group automatically inherits the group's access and permissions.

## Required permissions

To add members to a project and set their roles and permissions, you must have one of the following two roles:

* **Tenant admins** can manage member roles across multiple workspaces under the same organization and create new workspaces.
* **Admins** can manage member roles within one workspace and can't make changes to other workspaces under the same organization.

| Permission                                        | Tenant admin          | Admin                 |
| ------------------------------------------------- | --------------------- | --------------------- |
| Add members to the workspace                      | <Icon icon="check" /> | <Icon icon="check" /> |
| Remove members from the workspace                 | <Icon icon="check" /> | <Icon icon="check" /> |
| Create groups                                     | <Icon icon="check" /> | <Icon icon="check" /> |
| Add member to existing groups                     | <Icon icon="check" /> | <Icon icon="check" /> |
| Add groups to projects                            | <Icon icon="check" /> | <Icon icon="check" /> |
| Manage roles and permissions of workspace members | <Icon icon="check" /> | <Icon icon="check" /> |
| Create custom roles                               | <Icon icon="check" /> | <Icon icon="check" /> |
| Create new workspaces under the organization      | <Icon icon="check" /> |                       |
| Create custom API keys                            | <Icon icon="check" /> | <Icon icon="check" /> |

## Manage individual members

You can always grant a specific user access to a project or your entire workspace. This is useful for assigning administrative roles or for one-off project assignments.

### Invite members with a workspace-wide role

A workspace-wide role gives a user the same level of access to *every project* in the workspace. This is best for administrators, team managers, or stakeholders who need broad visibility.

1. Navigate to **Workspace settings** and select the **Members** tab.
2. Click **+ Invite members**.
3. Enter the email address(es) of the user(s) you want to invite.
4. Check the **Workspace-wide role** box.
5. Select a workspace-level role (e.g., Admin, Team Manager) from the **Role** dropdown menu.
6. Click **Invite**.

### Remove a member from the workspace

1. Navigate to **Workspace settings** in the bottom-left corner and select the **Members** tab.
2. Use the search bar to find the member whose role you want to modify.
3. Click the three-dot icon at the far right of the member's row.
4. Select **Remove** from the dropdown menu.
5. Confirm the action. The user will be removed from the workspace and will lose access to all of its projects.

### Invite members to specific projects

You can also give a user a role on one or more specific projects without giving them access to the entire workspace. This is the most common way to grant access to labelers or reviewers who only need to work on specific tasks.

1. Go to **Workspace settings** and select the **Members** tab.
2. Click **+ Invite members**.
3. Enter the email address(es) of the user(s).
4. Use the **Search projects** bar to find and select all the projects you want to assign to the user(s).
5. In the **Role in groups and projects** dropdown, select a project-level role (e.g., Labeler, Reviewer).
6. Click **Invite**.

### Remove a member from a specific project

1. Follow steps 1-3 above to open the member's detailed profile view.
2. Find the project you wish to remove the member from.
3. Click the **"X"** icon to the right of the project role.
4. Confirm the action. The user will lose access to that project but will retain access to any other projects they are assigned to.

## Manage teams at scale with groups

While you can manage everyone individually, using groups becomes essential as your team grows. Groups allow you to:

* **Manage at scale:** Onboard an entire team to a new project in a single step, rather than inviting dozens of people one by one.
* **Improve efficiency:** Update permissions for multiple users at once. If a team's responsibilities change, you only need to edit the group's settings.
* **Maintain clarity:** Keep your projects organized by creating groups that reflect your company's team structure (e.g., "Data Science Team," "Pedestrian Annotation Team," "External QA").

<Tip>
  **Best practice**: We recommend using groups as the primary way to manage project access.

  Managing individual permissions should be reserved for unique exceptions.
</Tip>

### Create a new group

First, you'll create a group and assign it to the relevant projects.

1. Navigate to the **Groups** tab in **Workspace settings**.
2. Click **New Group**.
3. Enter a descriptive name (e.g., "Video Annotation Team") and select a color.
4. Under **Assign Projects**, search for and select the projects this group will work on.
5. *Optional:* You can add initial members now, or add them later.
6. Click **Confirm**.

### Add members to a group

Once a group is created, you can add members. When you add a member to a group, they are automatically granted the appropriate role on all projects assigned to that group.

1. Go to the **Groups** tab and click on the group you want to modify.
2. Click **Add members**.
3. Enter the members' email addresses and click **Submit**. They will now have access to all of the group's projects.

<Info>
  To search for a member:

  * Select either **Workspace** or **Project** before searching, as each member belongs to only one scope, and searches can only be performed within the selected scope.
  * Use quick search options only if you are a labeling services customer. Otherwise, use the standard search options.
</Info>

### Manage project access for a group

If your team's focus shifts, you can easily add or remove projects from a group. This will update the access for all members of the group simultaneously.

1. Navigate to the **Groups** tab.
2. Find the group you wish to edit and click the three-dot icon, then select **Edit**.
3. In the **Assign Projects** section, add or remove projects as needed.
4. Click **Confirm** to save the changes.
