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

# User Groups

> Organize users into groups so you can manage access in one place.

<Info>
  User groups let you manage access for a team at once instead of person-by-person. This is the recommended way to grant access in Cedar.
</Info>

<Frame caption="User groups list">
  <img src="https://mintcdn.com/cedaraiinc/3XL8_nY45kQdoBAs/images/admin/user-groups-list.png?fit=max&auto=format&n=3XL8_nY45kQdoBAs&q=85&s=927b421bfcdbd8a611649fd51c19eb38" alt="User groups list with search" width="1440" height="900" data-path="images/admin/user-groups-list.png" />
</Frame>

## Why use groups?

<CardGroup cols={3}>
  <Card title="Easier management" icon="wand-magic-sparkles">
    Change access for many users at once
  </Card>

  <Card title="Clearer organization" icon="sitemap">
    Know exactly who has what access
  </Card>

  <Card title="Fewer mistakes" icon="shield-check">
    Reduce errors from individual assignments
  </Card>
</CardGroup>

## Create a group

<Steps>
  <Step title="Click Create Group" icon="plus">
    From the User Groups page or Dashboard, click the **Create Group** button.
  </Step>

  <Step title="Name your group" icon="pen">
    Choose a clear, descriptive name like:

    * "Customer Admins"
    * "Operations Team"
    * "Billing Specialists"

    <Tip>
      Use names that describe the team's function, not individual people.
    </Tip>
  </Step>

  <Step title="Add users" icon="user-plus">
    Search for and add the users who should be in this group.
  </Step>

  <Step title="Bind to a role" icon="link">
    Create a **binding** to connect this group to a role and scope. Without a binding, the group has no permissions.
  </Step>
</Steps>

<Frame caption="Create User Group dialog">
  <img src="https://mintcdn.com/cedaraiinc/3XL8_nY45kQdoBAs/images/admin/create-group-dialog.png?fit=max&auto=format&n=3XL8_nY45kQdoBAs&q=85&s=4d99ee1c935ff532c92429b247e0ef89" alt="Create User Group dialog with name, email, and description fields" width="1440" height="900" data-path="images/admin/create-group-dialog.png" />
</Frame>

### Dialog fields explained

| Field           | Required | Description                                                |
| --------------- | -------- | ---------------------------------------------------------- |
| **Name**        | Yes      | A descriptive name for the group (e.g., "Operations Team") |
| **Email**       | No       | Optional email address for the group                       |
| **Description** | No       | Brief description of the group's purpose                   |

## Group details

<Frame caption="Group detail view showing members and role assignments">
  <img src="https://mintcdn.com/cedaraiinc/3XL8_nY45kQdoBAs/images/admin/user-groups-detail.png?fit=max&auto=format&n=3XL8_nY45kQdoBAs&q=85&s=1904cc279e5e2b59543a6a7a3377eddd" alt="User group details panel" width="1440" height="900" data-path="images/admin/user-groups-detail.png" />
</Frame>

The detail panel shows:

* Group name and email
* Description
* Role assignments (via bindings)
* Members in the group

## Add or invite users to a group

Users are invited to Cedar through the User Group detail page. This ensures every user has proper access from the start.

<Steps>
  <Step title="Select a group">
    Click on a group to open its detail panel.
  </Step>

  <Step title="Click the add button">
    In the **Users in Group** section, click the **+** button.
  </Step>

  <Step title="Enter email addresses">
    Type user email addresses and click **Add** for each one.

    <Frame caption="Add users to group dialog">
      <img src="https://mintcdn.com/cedaraiinc/3XL8_nY45kQdoBAs/images/admin/invite-user-dialog.png?fit=max&auto=format&n=3XL8_nY45kQdoBAs&q=85&s=d1b8e588b5e3f336ff82d12133baf429" alt="Invite user dialog" width="1440" height="900" data-path="images/admin/invite-user-dialog.png" />
    </Frame>
  </Step>

  <Step title="Send invitations">
    Click **Add Users** to complete. New users receive an invitation email; existing users are added immediately.
  </Step>
</Steps>

<Tip>
  For details on user status and the invitation process, see the [Users documentation](/user-docs/admin/users).
</Tip>

## Best practices

<AccordionGroup>
  <Accordion title="Keep names simple and specific" icon="tag" defaultOpen>
    Good names describe the team's function clearly. Avoid generic names like "Team 1" or names that include specific people.

    | ✅ Good              | ❌ Avoid     |
    | ------------------- | ----------- |
    | Customer Admins     | Admin Team  |
    | Billing Specialists | John's Team |
    | Operations - West   | Group 1     |
  </Accordion>

  <Accordion title="Use groups as the default" icon="users">
    Always assign access through groups, even if there's only one person. This makes it easy to add more people later.
  </Accordion>

  <Accordion title="One group per role/scope combination" icon="layer-group">
    If different teams need the same role but on different scopes (e.g., different customers), create separate groups for each.
  </Accordion>
</AccordionGroup>

<Warning>
  A group without a binding has no permissions. After creating a group, always create a binding to grant access.
</Warning>

## Related pages

<CardGroup cols={2}>
  <Card title="Bindings" href="/user-docs/admin/bindings" icon="link">
    Connect groups to roles
  </Card>

  <Card title="Roles" href="/user-docs/admin/roles" icon="key">
    Define what groups can do
  </Card>

  <Card title="Users" href="/user-docs/admin/users" icon="user">
    Manage individual accounts
  </Card>

  <Card title="Glossary" href="/user-docs/admin/glossary" icon="book">
    Key terms explained
  </Card>
</CardGroup>
