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

# Groups

> Organize users into groups with shared roles

> [!NOTE]
>
> **Groups** is only available for **Workspace Admin**.

**Groups** organize users into sets that share role assignments. Open **Admin** → **User Management** → **Groups**.

![Groups page in Workspace Admin](https://mintcdn.com/utopikai/wjuuT4EwTFZDwCVu/images/user_management/Groups.png?fit=max\&auto=format\&n=wjuuT4EwTFZDwCVu\&q=85\&s=13b84a118a84190a2ff2fd9cd4f62d17)

## What you can do

| Control | What it does |
| - | - |
| **Search groups** | Find a group by name |
| **Create group** | Add a new group |

## Groups table

| Column | What it shows |
| - | - |
| **Name** | Group name |
| **Description** | Short summary of the group |
| **Members** | How many users are in the group |
| **Roles assigned** | Roles shared by members of the group |
| **Actions** | Row menu for further options |

The footer shows the total number of rows and the rows-per-page setting.

Use groups when several people should receive the same role, instead of assigning that role to each user one by one.

## Create a group

Click **Create group**. The flow has three steps: **Group Details**, **Assigned Roles**, and **Add members**.

### 1. Group Details

Set the group name and description, then **Continue**.

![Create group — Group Details](https://mintcdn.com/utopikai/wjuuT4EwTFZDwCVu/images/user_management/CreateGroupDetails.png?fit=max\&auto=format\&n=wjuuT4EwTFZDwCVu\&q=85\&s=e7202a96ae2923d1ea660d9f5e95eb65)

| Field | Required | What it does |
| - | - | - |
| **Group name** | Yes | Name shown in the groups list |
| **Description** | Yes | Short summary of what the group is for |

Click **Cancel** to close without creating a group.

### 2. Assigned Roles

Assign roles that members of this group inherit. If none are set yet, the empty state is *No roles assigned yet.*

![Create group — Assigned Roles](https://mintcdn.com/utopikai/wjuuT4EwTFZDwCVu/images/user_management/CreateGroupRoles.png?fit=max\&auto=format\&n=wjuuT4EwTFZDwCVu\&q=85\&s=d28a1d409849ab3b3cf2bbd9e6e50b11)

Click **+ Add role**, search or browse the catalog, select one or more roles, then **Add**.

![Create group — Add role](https://mintcdn.com/utopikai/wjuuT4EwTFZDwCVu/images/user_management/CreateGroupAddRole.png?fit=max\&auto=format\&n=wjuuT4EwTFZDwCVu\&q=85\&s=4e10761ec9bcbfa3e15485ee18942944)

Click **Continue** to add members. You can continue without assigning a role and add one later.

### 3. Add members

Add people to the group, then **Create group**. If none are selected yet, the empty state is *No members selected yet.*

![Create group — Members](https://mintcdn.com/utopikai/wjuuT4EwTFZDwCVu/images/user_management/CreateGroupMembers.png?fit=max\&auto=format\&n=wjuuT4EwTFZDwCVu\&q=85\&s=738bf5a106ee8d1a3174c74471c8d018)

Click **+ Add members**, search by email, select people, then **Add**.

![Create group — Add members](https://mintcdn.com/utopikai/wjuuT4EwTFZDwCVu/images/user_management/CreateGroupAddMembers.png?fit=max\&auto=format\&n=wjuuT4EwTFZDwCVu\&q=85\&s=a948b67006c9f1d6988230287023b595)

Use **Back** to change details or roles. After you create the group, it appears in the groups list with member and role counts.

## Related documentation

* [User Management Overview](https://docs.utopikai.com/user_management/overview.md)
* [Users](https://docs.utopikai.com/user_management/users.md)
* [Roles](https://docs.utopikai.com/user_management/roles.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.