This module was written to extend the standard functionality regarding users and groups management. It helps creating well-defined user roles and associating them to users.
It can become very hard to maintain a large number of user profiles over time, juggling with many technical groups. For this purpose, this module will help you to:
> - define functional roles by aggregating low-level groups, > - set user accounts with the predefined roles (roles are cumulative), > - update groups of all relevant user accounts (all at once), > - ensure that user accounts will have the groups defined in their > roles (nothing more, nothing less). In other words, you can not set > groups manually on a user as long as there is roles configured on > it, > - activate/deactivate roles depending on the date (useful to plan > holidays, etc) > - get a quick overview of roles and the related user accounts.
That way you make clear the different responsabilities within a company, and are able to add and update user accounts in a scalable and reliable way.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Lets administrators define reusable user roles that bundle several access groups, assign them to users (optionally with start and end dates), and automatically keep each user's groups in line with their roles.
This module adds a new "User Roles" menu under the Users section. A role is a named bundle of existing access groups; when a role is saved, every user linked to it gets exactly the groups of their active roles, and groups not covered by any role are removed.
On each user form a new "User Roles" tab lists the roles assigned to that user, with optional From and To dates. A role line outside its dates is shown greyed out and is ignored. When a user has at least one active role, an information banner on the Access Rights tab warns that access rights are managed by roles and manual changes there will not persist.
- Roles can be marked "Default on new users" so they are assigned automatically when a user is created.
- A role form shows counters for Access Rights and Record Rules coming from its groups, with buttons to open them.
- An "Add Multiple Users" button on a role adds several users at once, with optional dates.
- Wizards create a role from a user's current groups, or create a role from selected groups.
- A scheduled job "Update user roles" runs every 3 hours to reapply roles to all users.
- The group form shows a button with the number of roles a group belongs to.
- Users can be searched by role, and roles appear as tags in the user list.
Everything is restricted to administrators (erp manager).
Depends on
Required by other modules
Menus it adds
Models and fields (7)
- res.users · extends an existing modelshow_alert, role_line_ids (Role lines), user_role_ids (Roles)
- res.groups · extends an existing modelrole_id, role_ids (User Roles), parent_ids (Parents), role_count (# User Roles), view_access, trans_parent_ids (Parent Groups)
- res.users.role · new modelgroup_id (Associated group), line_ids (Role lines), rule_ids (Record Rules), sequence, is_default (Default on new users), rules_count, role_user_ids (Users list), model_access_ids (Access Rights), group_privilege_id (Associated privilege), model_access_count
- res.users.role.line · new modelname, active, date_to (To), role_id (Role), user_id (User), sequence, date_from (From), is_enabled (Enabled)
- role.add.users.wizard · new modeldate_to (To), role_id, user_ids (Users), date_from (From)
- wizard.groups.into.role · new modelname
- wizard.create.role.from.user · new modelname, assign_to_user (Assign to user)
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 8 confirmed, 1 with no information of 9 versions.
Sources · Odoo 16.0
Confirmed on 2026-11-03 in branch 16.0 of OCA/server-backend.
terminal Installation and usage
OCA documentation · Odoo 19.0Configuration
Source · Odoo 19.0To configure this module, you need to go to Settings / Users / Roles, and create a new role. From there, you can add groups to compose your role, and then associate users to it.
You can also define default roles for a new user by editing the user called "Default User".
Roles:
Add groups:
Add users (with dates or not):
Instead of creating roles from scratch, it is possible to create a role based on the groups of an existing user: select or open the user and choose "Create role from user" in the action menu.
Usage
Source · Odoo 19.0To use this module, you need to:
- Go to Configuration / Users / Users choose user and set Roles:
No verified information in OCA: Installation.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.