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

# User groups

User groups allow you to manage access control efficiently by organizing users into logical groups with shared permissions. Instead of assigning permissions to individual users, you can assign them to a group, and all members of that group will inherit those permissions.

## Managing User Groups

<Tip>Take a quick tour to learn how to manage user groups using the demo below.</Tip>

<div style={{ marginBottom: '180px', position: 'relative', paddingTop: '230px' }}>
  <iframe src="https://demo.arcade.software/aWKLIuQpiOqNstQKI3dM?embed&embed_mobile=tab&embed_desktop=inline&show_copy_link=true" frameBorder="0" loading="lazy" webkitAllowFullScreen="" mozAllowFullScreen="" title="Manage Access Control and User Groups in Organization Settings" style={{ position: 'absolute', top: '0px', left: '0px', width: '100%', height: '400px', colorScheme: 'light' }} />
</div>

You can view and manage user groups from the organization settings.

<Steps>
  <Step title="Navigate to User Groups">
    Go to **Settings** in the left sidebar, then click on **User groups** under **Organization settings**.
  </Step>

  <Step title="View User Groups">
    On this page, you will see a list of all user groups within your organization, showing their name, the number of members, and a description.
  </Step>

  <Step title="Create a New User Group">
    Click the `+ Add` button in the top-right corner to create a new user group. You will need to provide a name and an optional description.
  </Step>

  <Step title="Manage Group Members">
    After creating a group, you can add or remove members at any time.
  </Step>
</Steps>

### Default User Group: `everyone`

Every organization includes a default user group called **everyone**.

* **Description**: All members of the organization are automatically included in the **everyone** user group.
* **Management**: This is a VESSL-managed group. You cannot edit its members or delete the group.
* **Usage**: This group is useful for granting read-only access to non-critical resources across the organization. For more details, see the [Default Permissions section in our Access Control guide](./access-control#default-permissions).

### Using User Groups for Access Control

Once you have created user groups, you can assign permissions to them on the **Access Control** page of any **Target** (e.g., Project, Workspace, Pipeline). This simplifies permission management, especially in large teams.

For more information on how permissions work, read the [Access Control guide](./access-control).