openproject/docs/system-admin-guide/users-permissions/groups/README.md

---
sidebar_navigation:
  title: Groups
  priority: 980
description: Manage groups in OpenProject.
robots: index, follow
keywords: manage groups
---

# Manage Groups

<div class="glossary">
A **Group** is defined as a list of users which can be assigned to a project with a selected role. New groups can be defined in *Administration -> Users & Permissions -> Groups*.
</div>

OpenProject allows creating tailored project member **groups**, which  grant additional permissions to individual users within a project. Instead of adding individual users to a project you can add a user group, e.g. Marketing. You can edit existing groups, create new ones, add and remove users or delete groups.

## Add a new group

After selecting **Groups** from the administration menu a list of the existing groups is shown, or a prompt to create a group if none exist.

Click the green **+ Group** button to create a new group.

![create groups](image-20200211142053557.png)

![no existing groups](image-20200115164118182.png)

Give a name for your new group, which must be unique, and click the blue **Create** button.

![new group](image-20200115164328352.png)

## Add users to a group, edit or remove groups

You can add users to a group and edit a group by clicking on the **name of the group** (1) and  delete the group by clicking on **delete** icon in the respective line (2).

![Sys-admin-edit-groups](Sys-admin-edit-groups.png)

After clicking on a group's name, you can **change the group name**, **add or remove group members** and **assign groups to projects**.

![edit groups](image-20200115164847858.png)

### Add users to a group

Click the **Users** tab. Select the users you want to add to this group from the "New user" drop-down list. Click the blue **Add** button. Users already in the group are not shown in the list. Click the "X" against the user to remove that user from the group.

![Sys-admin-add-users-groups](Sys-admin-add-users-groups.gif)

Adding a user to a group also adds that user to the member list of *all* projects in which this group was assigned a [role](../roles-permissions) (e.g. Member).

Removing a user from a group removes the role from that user in any project using that group. If the user has no other roles (i.e. who were only added as a member of this group and not individually) they are removed from the respective project completely.

### Add projects to a group

Click the **Projects** tab. Select the projects you want to add this group to from the "New project" drop-down list. Tick the roles that you want the group to have. Click the blue **Add** button. Users in the group are added to that project's members using the role selected.

## Delete a group

To delete a group click on the **delete** icon in the respective line of the group list.

Deleting a group removes the role from the members of any project using that group. If any user has no other roles (i.e. who were only added as a member of this group and not individually) are removed from the respective project completely.

## Impact of groups on project members

Groups have the following impact on a [project members list](../../../getting-started/invite-members) and the [user details](../users). Changes in groups, project members or users may affect the other two.

Find out more about the behavior of groups as project members from a project admin's perspective [here](../../../getting-started/invite-members/#behavior-of-groups-as-project-members