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

# User Group

> Organize users and metrics into groups for human evaluation workflows

## What is a User Group?

A **User Group** organizes users and metrics within an organization to streamline human evaluation workflows.

User Groups serve two key purposes:

1. **Assigning evaluators**: Group users who should review and annotate AI outputs for specific metrics.
2. **Scoping metrics**: Link metrics to groups so that only users in those groups see pending evaluations for those metrics.

When a [Human Evaluation](/concepts/metric/evaluation-types#human-evaluation) metric is linked to a user group, only users in that group will see pending evaluations for that metric in the **Human Evaluations** page of the dashboard.

## Managing User Groups

User groups can be managed in two places:

* **Dashboard**: Navigate to an organization's **Groups** tab to create, edit, and delete groups. From metric and user detail pages, you can also assign and unassign groups.
* **SDK**: Use the `galtea.user_groups` service for programmatic management. See the [Human Evaluation tutorial](/sdk/tutorials/human-evaluation) for a step-by-step guide.

## SDK Integration

<Card title="User Group SDK API" icon="code" href="/sdk/api/user-group/service">
  Create, list, update, and delete user groups programmatically. Link and unlink users and metrics.
</Card>

## User Group Properties

<ResponseField name="id" type="string">
  Unique identifier for the user group.
</ResponseField>

<ResponseField name="organization_id" type="string">
  The organization this group belongs to.
</ResponseField>

<ResponseField name="name" type="string" required>
  Name of the user group.
</ResponseField>

<ResponseField name="type" type="string" required>
  Type of user group. Currently only `EVALUATOR` is supported.
</ResponseField>

<ResponseField name="description" type="string" optional>
  Description of the group's purpose.
</ResponseField>

<ResponseField name="user_ids" type="list[string]">
  IDs of users in this group.
</ResponseField>

<ResponseField name="metric_ids" type="list[string]">
  IDs of metrics linked to this group.
</ResponseField>

## Related

<CardGroup cols={2}>
  <Card title="Concepts overview" icon="diagram-project" iconType="solid" href="/concepts/overview">
    How Galtea's concepts connect — diagram + per-entity quick reference.
  </Card>

  <Card title="Human Evaluation Tutorial" icon="clipboard-check" href="/sdk/tutorials/human-evaluation">
    Step-by-step guide to the full annotation workflow with screenshots.
  </Card>

  <Card title="User Group SDK API" icon="code" href="/sdk/api/user-group/service">
    Programmatic management of user groups.
  </Card>
</CardGroup>