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

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

Here is a view of this page:
image:images/UI2021.1/roles-portal.png[Administrator roles Portal]

On this page, an Administrator can:

== View the users directly mapped to a role

. Go to _Organization_/_Roles_
. In the row of the role, click on the _View the list of users mapped with this role_ 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 role:

* create
* delete
* edit the name and description
* modify users within
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 role

. Go to _Organization_/_Roles_
. Click on the _Create_ button
. In the modal window, enter the name (can be technical), the display name, and a description of the role
. Click on _Create_
The new role will be displayed in the list of roles.

=== Delete a role

. Go to _Organization_/_Roles_
. In the row of the role, click on the _Delete_ icon
. In the modal window, click on _Delete_
. In the confirmation modal, after checking that it is safe to delete, click on _Delete_

=== Edit a role name and description

. Go to _Organization_/_Roles_
. On the row of the role, click on the _Edit role details_ icon
. In the modal window, update the role information
. Click _Save_

== Modify users in a role

In the way we conceive how 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
. On the row of the 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_
