# Managing user groups

As an app administrator at both the app store and application levels, you can learn how to add and modify user groups.

### Choose who sees what

A user group is a group of users who share the same permissions and/or app access privileges.\
Think of it as a filter on data 🔐 that can also simplify the governance process by providing the same app access to all users in a group.

📝 “My users from the group France can only see France’s data and reports”\
📝 “I want all users from the group France to have a view access to the Finance application”

The process consists of two steps:

* Assign users and privileges to groups
* Assign permissions to groups

### User groups

As an admin, you can manage user groups from the **Groups** menu in the user interface at the platform level.

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-975252fe4b0d520e10566b83b0996a4f8d88ed8d%2Fgroups-panel.png?alt=media" alt="groups-panel"><figcaption></figcaption></figure>

#### Create groups

You can create users from the **Create groups** at the top right side of your screen.

{% hint style="info" %}
**Hint**

Groups can also be assigned during user creation or through bulk editing
{% endhint %}

Creating groups involves three steps :

* General infos
* Edit privileges
* Notification settings

**General infos**

In this step, you need to :

* Give your group a name
* Select user(s) for your group

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-1611404a34fe932e78021a5cf6a03285a2117918%2Fcreate-group.png?alt=media" alt="create-group"><figcaption></figcaption></figure>

{% hint style="info" %}
**Hint**

if users belong to multiple groups with different app access, the most permissive access for each app will be applied.

Admins will always keep their admin privilege if belonging to a group.
{% endhint %}

**Edit privileges**

In this step, you need to define, application by application, which access to give to users belonging to the group.

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-59108a9993915d67b825c507e70e6901652579f0%2Fgroup-privileges.png?alt=media" alt="group-privileges-edit"><figcaption></figcaption></figure>

{% hint style="info" %}
**Hint**

You can also choose not to apply privileges at the group level. Users will keep the app access defined individually (if they don't belong to a group with privileges). Just turn on the option at the bottom left.
{% endhint %}

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-073ac33f1df9e532d4b7dad37106524da6ea3394%2Fgroup-user-privileges.png?alt=media" alt="group-user-privileges"><figcaption></figcaption></figure>

**Notification settings**

If you choose to use privileges at the group level, you can choose how to notify users of their access 💌.

<figure><img src="https://1809014303-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZxYYf1KpgarKMgMsDCrw%2Fuploads%2Fgit-blob-2bb4e6373f97d016cff002e98af65800302b6d81%2Fgroup-send-email.png?alt=media" alt="group-notifications"><figcaption></figcaption></figure>

#### Edit groups

Once your group is created, you can update it directly from the menu.\
From the menu, you can change, on-the-fly, the group app access and notify users belonging to the group. You can also choose to remove privileges at the group level :

* Users that had individual privileges before joining the group will be switched back to their individual access
* Users that never had individual access will have no access by default, and you will need to update their access in the user menu

**Edit one group**

Selecting a group from the menu enables the editing toolbar.\
You can use this toolbar to:

* Add/remove users to/from your group
* Notify users of their access
* Delete the selected group

**Edit multiple groups**

Selecting multiple groups from the menu enables the editing toolbar.\
You can use this toolbar to:

* Add/remove/change privileges of users in the selected groups
* Notify users of their access
* Delete the selected groups

### Permissions

📖 **Learn more** about permissions with [this documentation](https://docs-v3.toucantoco.com/administration/managing-users/setting-up-permissions-and-visibilities) !
