## Organize teams in groups

URL: https://docs.atlan.com/product/capabilities/governance/access-control/how-tos/manage-groups

> Create groups in Atlan, add or remove users, and delete groups you no longer need to manage team access at scale.

Group your users by team or function so you can grant access in bulk instead of editing individual user permissions. Once a group exists, you assign it to [personas](https://docs.atlan.com/llms/governance/access-control/create-a-persona/llms.txt) and [purposes](https://docs.atlan.com/llms/governance/access-control/create-a-purpose/llms.txt), and every member of the group inherits that access automatically. Use this page to create groups manually, add or remove users, and clean up groups you no longer need.

## Prerequisites

Before you manage groups, make sure:

- You are an **admin** in Atlan. Members and guests cannot create or modify groups.
- You have a plan for which **users** belong in each group, and which **personas or purposes** the group will receive.
- If you want to keep group membership in sync with your identity provider instead of managing it manually, set up [Sync groups from your IdP](https://docs.atlan.com/llms/governance/access-control/automatically-assign-groups/llms.txt) before creating groups by hand.

## Create group

1. In Atlan, click **Settings** from the left menu, then click **Groups** to see all existing groups in your workspace.

 If you are using the old UI, click **Admin** from the left menu, then **Users & Groups → Groups**.

2. Click **Create Group** in the top right. The _Create group_ dialog opens.

3. Fill in the group details:

 - **Name** (required): A short, descriptive label for the group, for example `Marketing Analysts` or `Data Engineering`.
 - **Alias**: An optional short identifier used in APIs and integrations.
 - **Description**: A note for other admins explaining what the group is for and who belongs in it.
 - **Slack**: If you have [Slack integrated](https://docs.atlan.com/llms/governance/integrations/integrate-slack/llms.txt), enter the name of the corresponding Slack channel (without the `#`). Members can then jump directly to the channel from the group page in Atlan.

4. Click **Create Group**. The group appears in the Groups list and is ready for you to add users.

## Add users to group

You can add users to a group from either side of the relationship: open the group and add users to it, or open a user and add them to one or more groups. Both flows reach the same result.

### From the group

1. In **Settings → Groups**, click the group you want to add users to.

 If you are using the old UI, go to **Admin → Users & Groups → Groups** and click the group.

2. Click **Add Members** (or **Manage Users**) to open the user picker.

3. Search for and select the users you want to add. You can select multiple users at once.

4. Click **Add** (or **Save**). The selected users now belong to the group and immediately inherit any personas or purposes assigned to it.

### From a user

1. In **Settings → Users**, click the user you want to add to a group.

 If you are using the old UI, go to **Admin → Users & Groups → Users** and click the user.

2. Click **Edit** (or **Manage Groups**) and check the groups they should belong to.

3. Click **Save**. The user is now a member of those groups, and immediately inherits any personas or purposes assigned to them.

## Remove users or delete group

To remove a single user, return to **Settings → Groups → \[your group\]**, find the user in the members list, and click **Remove** next to their name. If you are using the old UI, go to **Admin → Users & Groups → Groups → \[your group\]**.

To delete a group, return to the Groups list, find the group, click **Delete** (or **Remove**), and confirm. Deleting a group removes all users from it and revokes any access they inherited only through that group. Review the group's personas and purposes before deleting.

## Need help?

If you run into issues while managing groups, contact [**Atlan Support**](https://docs.atlan.com/support/submit-request) for assistance.

## Next steps

- [Sync groups from your IdP](https://docs.atlan.com/llms/governance/access-control/automatically-assign-groups/llms.txt): Keep group membership aligned with your identity provider automatically.
- [Assign roles by group name](https://docs.atlan.com/llms/governance/access-control/assign-roles-based-on-group-names/llms.txt): Set each user's role from their group membership.

---