# Groups

> Manage team groups and the access they grant to artifacts and projects.

Kind: guide · ~3 min · Verified v0.257.2 · Next: [Bulk invite](https://pr-2362-stg.superartifacts.app/docs/bulk-invite.md)

## Goal

Manage a set of teammates and their shared access together.

## What you'll have

A named group of team members, with grants to selected artifacts or projects.

## Needs

An Owner in the workspace. Invite people and wait for them to join before adding them to a group. Guests and pending invitees cannot join groups.

## Prompt

No agent prompt is needed. Open **Settings → Team → Groups** in the dashboard.

## Steps

1. Choose **New group**, enter a group name and choose **Create group**. A workspace can have 50 groups. Names are limited to 60 characters and must be unique, ignoring letter case.
2. Open the group's actions menu and choose **Manage members**. Select the teammates who belong in it. You can also select members in the People table and choose **Actions → Add to group…** or **Remove from group…**, select the group in the dialog, then confirm. Commenters appear in Guests and can belong to groups.
3. Choose **Grant to…** in the group's actions menu. Select an artifact or project and the access role, then choose **Grant access**. Active members receive that grant. The available targets come from the products connected to the workspace.
4. To share from an artifact or project instead, find the group by name in its sharing picker. A group row shows its member count. The server resolves its members when saving access.

Adding or removing a member updates group-derived access. A higher direct share still applies. Removing someone from the team removes them from its groups. Deactivation keeps membership but pauses group access. Reactivation restores it when a seat is available for a paid role.

Choose **Rename** to change a group's name. Choose **Delete** to remove the group and its grants after reading the confirmation. Direct shares remain.

## Check it worked

Open a person in the People table to see their groups and listed access, including items granted via a group. The list covers named and group grants; other access can come from their role or an Owner. Open the group's row to check membership and grants. Sign in as a group member and open the item you granted.

## If not

Read the result beside the action. Only Owners manage groups. Paused or frozen workspace rules can refuse changes. If an update fails, reload the page to check the saved membership and grant before retrying.

## Variations

Use groups for departments, project teams or review circles. Groups contain workspace members; they do not nest inside other groups.

## Next

[Invite people in bulk](https://pr-2362-stg.superartifacts.app/docs/bulk-invite.md) or review [workspace roles](https://pr-2362-stg.superartifacts.app/docs/teams.md).
