= Group list in Bonita Administrator Application
:description: This page explains what a user with the Administrator profile can see and do about groups in Bonita Administrator Application.

This page explains what a user with the _Administrator_ profile can see and do about groups (of the organization) in xref:admin-application-overview.adoc[Bonita Administrator Application]. +
To easily manipulate users with the same rights, it is possible to group them together. +
Groups can be defined in the organization, users can then be added to groups, and groups can be used to map actors or profiles or other permissions in Bonita.

Here is a view of this page:
image:images/UI2021.1/admin-application-groups-list.png[Administrator groups list Portal]

On this page, an Administrator can:

== View the sub-groups of a group

. Go to _Organization_/_Groups_
. In the row of the group, click on the _View sub-groups_ icon

== View the users directly mapped to a group

. Go to _Organization_/_Groups_
. In the row of the group, click on the _view users in the group_ icon
. In the modal window, if you require more information about the user, go to the end of his row and click on the _View user details_ icon to navigate to the user details page.

== Live Update

The Administrator can xref:live-update.adoc[Live Update] a group:

* create
* delete
* edit the name, description, and parent group
* modify users within a group

This is only in case of an issue to solve temporarily. We strongly encourage the modification of the organization to be conducted
in Bonita Studio so it can be shared and versioned with the whole project, or through the xref:ldap-synchronizer.adoc[LDAP synchronizer] if the organization is located in an external system.

=== Create a group

. Go to _Organization_/_Groups_
. Click on _Create_
. In the modal window, enter the name (required, can be technical), the display name, the parent group, and a description. By default, the display name will be the (technical) name
. Click on _Create_

[NOTE]
====

Bonita does not accept the '/' character in the group name field. A group name that contains a '/' may lead to unstable behaviour.
====

=== Delete a group

. Go to _Organization_/_Groups_
. In the row of the group, click on the _Delete group_ icon
. In the confirmation modal window, after checking that the group has no subgroups, click on _Delete_

=== Edit a group name and parent group

. Go to _Organization_/_Groups_
. In the row of the group, click on the _Edit group_ icon
. In the modal window, update the group information
. Click on _Save_.

=== Modify users within a group

In the way we conceive the way a user pertains to an organization, it is only possible to add both a role and a group (what we call a membership) to a user.  +
For example, "Assistant"(role) of "Human Resources"(group).

. Go to _Organization_/_Users_. You navigate to the xref:admin-application-users-list.adoc[Users] page.
. In the row of a user, click on the _View user details_ icon
. Click on _Profiles_ / _Memberships_
. To delete a membership, click on the _Delete_ icon of an existing membership
or to add a membership, click on the _+_ button, select the role and the group for the user, and click on _Add_
