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-20210505162541644.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" next to a user to remove that user from the group.

![add-users-to-group](image-20210302095755016.png)

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 a group to projects

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 a user has no other roles (i.e. who were only added as a member of this group and not individually) he/she is removed from the respective project completely.

## Impact of groups on project members

Groups impact [project members lists](../../../getting-started/invite-members) and [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). 

## Group profile

Similar to users, groups have a profile page which shows their name and members. Each member of a group is only visible for users with the necessary permissions (e.g. user has permission to see this member in a common project or user is system administrator). 

![group-profile-page](image-20210302144820982.png)

The profile page can be accessed via the group's [settings page](/#add-users-to-a-group-edit-or-remove-groups), via the overview page of projects the group is a member of and via [mentions](../../../user-guide/work-packages/edit-work-package/#-notification) of the group.