---
title: "Grant roles through user groups"
description: "Group people by team or function, give the group roles that every member inherits, and switch a group off without losing its setup."
url: https://helpcenter.complytrain.net/en/articles/201-grant-roles-through-user-groups
collection: "Users and access"
updated: 2026-09-22
language: en
---

# Grant roles through user groups

Group people by team or function, give the group roles that every member inherits, and switch a group off without losing its setup.

Group people by team or function, give the group roles that every member inherits, and switch a group off without losing its setup.

A user group gives roles to many people at once. Every member inherits every role assigned to the group, for as long as the group is active. Adding a new colleague to the right group gives them the right access in one step, and the group shows at a glance who holds that access and why. Only organisation **Admins** can manage groups.

## How group roles combine

Product location: `/settings/roles/groups`. Open Roles & Permissions in Settings, then User Groups.

A person's access is the union of the roles they hold directly and the roles of every active group they belong to. Nothing is subtracted: a role from one path is never cancelled by another.

-   Removing a direct role does not remove the same role when a group still gives it.
    
-   Removing someone from a group removes only the roles they held through that group.
    
-   An inactive group keeps its members and roles but gives nobody anything.
    

A person's **Role & Permissions** tab lists their direct roles under **Platform Roles** and group roles under **Inherited from groups**, for example "Quality Auditor via group Internal Auditors". A role's page lists the groups that give it under **Groups with this role**. When a vault access grant names a role, the members of every active group with that role get the access too.

Roles never widen an [account class](https://help.complytrain.net/en/settings/account-classes/): a training learner in a group still uses only Training, and a pending user has no access until they get a seat.

## Starter groups

Product location: `/settings/roles/groups`. Open Roles & Permissions in Settings, then User Groups.

When Quality Management is set up for your organisation, ComplyTrain creates five groups, each linked to the matching system role:

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Group</p></th><th colspan="1" rowspan="1"><p>Role it gives</p></th><th colspan="1" rowspan="1"><p>For</p></th></tr><tr><td colspan="1" rowspan="1"><p>Quality Management</p></td><td colspan="1" rowspan="1"><p>Quality Manager</p></td><td colspan="1" rowspan="1"><p>People who administer the quality management system.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Process Owners</p></td><td colspan="1" rowspan="1"><p>Process Owner</p></td><td colspan="1" rowspan="1"><p>People who own processes and their evidence, complete tasks and submit forms.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Document Authors</p></td><td colspan="1" rowspan="1"><p>Document Controller</p></td><td colspan="1" rowspan="1"><p>People who write and control documents.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Internal Auditors</p></td><td colspan="1" rowspan="1"><p>Quality Auditor</p></td><td colspan="1" rowspan="1"><p>People who plan and conduct internal audits.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Read Only</p></td><td colspan="1" rowspan="1"><p>QMS Viewer</p></td><td colspan="1" rowspan="1"><p>People who need read access without authoring rights.</p></td></tr></tbody></table>

They are ordinary groups: you can rename them, change their roles, add your own groups or delete the ones you do not need. Colleagues you invite during a Quality Management standard kick-off join the matching starter group by its name, so keep the names if you use kick-off invitations.

## Create a group

Product location: `/settings/roles/groups`. Open Roles & Permissions in Settings, then User Groups.

1.  Open **Settings**, then **Roles & Permissions** and **User Groups**, or choose **User Groups** on the roles page.
    
2.  Choose **Create Group**. **Create User Group** opens.
    
3.  Enter the **Name** and, optionally, a **Description**.
    
4.  Choose **Create**. The group appears in the list, active and empty.
    

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Field</p></th><th colspan="1" rowspan="1"><p>Rules</p></th></tr><tr><td colspan="1" rowspan="1"><p>Name</p></td><td colspan="1" rowspan="1"><p>Required, up to 100 characters. No other group may have the same name.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Description</p></td><td colspan="1" rowspan="1"><p>Optional, up to 500 characters. Say which team or function the group represents.</p></td></tr></tbody></table>

The list shows each **Group** with its **Description**, number of **Members** and number of **Roles**, and an **Inactive** badge where it applies. **View Details** or the group name opens the group; **Back to User Groups** returns to the list.

## Add and remove members

Product location: `/settings/roles/groups/{groupId}` (fallback: `/settings/roles/groups`). Open the group with View Details.

1.  Open the group. Under **Members**, type part of a name or email address in **Search users by name or email...** and choose **Search**, or press Enter.
    
2.  Choose **Add** next to the person. The membership is saved at once, and the person appears in the member list.
    
3.  To remove someone, choose **Remove** beside their name and confirm **Remove member?**: "… will lose every role inherited through this group."
    

The search leaves out people who are already members; **No matching users found (existing members are excluded).** appears when nobody else matches. A person can belong to any number of groups.

## Assign roles to a group

Product location: `/settings/roles/groups/{groupId}` (fallback: `/settings/roles/groups`). Open the group with View Details.

1.  Open the group. **Assigned Roles** lists every role in your organisation, with a **System** badge on roles ComplyTrain provides.
    
2.  Tick the roles the members should inherit and clear the ones they should not.
    
3.  Choose **Save Changes**. **Group roles updated** confirms it. **Cancel** restores the saved selection.
    

**No roles are available yet. Create roles first.** appears when your organisation has no roles. Create one in [create roles and choose their permissions](https://help.complytrain.net/en/settings/role-permission-review/).

## Edit, deactivate or delete a group

Product location: `/settings/roles/groups/{groupId}` (fallback: `/settings/roles/groups`). Open the group with View Details and choose Edit. Delete is on the group's row in the list.

To change the group itself, open it and choose **Edit**:

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Field</p></th><th colspan="1" rowspan="1"><p>What it does</p></th></tr><tr><td colspan="1" rowspan="1"><p>Name, Description</p></td><td colspan="1" rowspan="1"><p>The same rules as when you created the group.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Group is active</p></td><td colspan="1" rowspan="1"><p>"Deactivating is a soft off-switch: membership and role links are kept, but the group grants nothing."</p></td></tr></tbody></table>

Choose **Save Changes**. **Group updated** confirms it. An inactive group shows the **Inactive** badge and the note "This group is inactive: members keep their membership but inherit no roles from it." Tick **Group is active** again to restore every member's inherited roles exactly as they were.

To remove a group for good, choose **Delete** on its row in the group list. **Delete group?** warns: "This permanently deletes the group … Its members lose every role they inherited through it." Deactivate instead when you may need the group again.

## Example: Internal auditors

Product location: `/settings/roles/groups`. Open Roles & Permissions in Settings, then User Groups.

Your internal auditors need Quality Auditor rights in Quality Management, and during audit rounds also read access to the risk register and the control library.

1.  Create a custom role **Audit read access** with `rms:view_risks`, `rms:view_reports` and `controls:view_controls`; see [create roles and choose their permissions](https://help.complytrain.net/en/settings/role-permission-review/).
    
2.  Open **User Groups** and the **Internal Auditors** starter group. It already gives **Quality Auditor**.
    
3.  Under **Assigned Roles**, also tick **Audit read access** and choose **Save Changes**.
    
4.  Under **Members**, search for and **Add** each auditor.
    
5.  Open one auditor's **Role & Permissions** tab and check that both roles are listed under **Inherited from groups** "via group Internal Auditors".
    
6.  If the auditors also review a document vault, grant the **Quality Auditor** role auditor access on that vault; see [configure vaults and access grants](https://help.complytrain.net/en/document-vault/vault-access/).
    

Between audit rounds, edit the group and clear **Group is active**. The auditors keep their direct roles and their training, lose the audit access at once, and get it back when you tick **Group is active** for the next round.

## When changes take effect

Product location: `/settings/roles/groups`. Open Roles & Permissions in Settings, then User Groups.

Adding or removing a member, changing a group's roles, and activating or deactivating a group apply immediately, without signing out. The affected people may need to refresh their browser for menus and buttons to catch up.
