Create and Maintain Roles
Create roles, edit permission sets, replace roles, and delete roles safely.
Use this guide when you need to define or maintain the permission bundle itself.
Before you begin
You need:
- Admin access to roles and permissions.
- A clear job the role supports.
- The dashboard, pages, and actions the role needs.
- Awareness of any users currently assigned to the role.
Use manage and wildcard permissions carefully. They are meant for broad
administrative work, not routine viewing.
Open the Roles page
- Open Admin Dashboard.
- Go to Settings.
- Open Users & Access.
- Select Roles.
The page includes Create Role, Role Permission Matrix, role cards, Edit Permissions, and delete role actions.
Create or edit a role
To create a role:
- Select Create Role.
- Enter Role Name.
- Enter Description.
- Expand each permission category you need.
- Select individual permissions, or select a category checkbox.
- Review the selected permission count.
- Select Create Role.
To edit permissions:
- Find the role card.
- Select Edit Permissions.
- Expand the permission categories.
- Select or clear permissions.
- Check the permissions selected count.
- Select Save Changes.
Use role names that describe the job, not a person, such as Course Author, Reports Viewer, Group Manager, Support Admin, or Live Learning Coordinator.
Replace or delete a role
The visible role matrix does not provide a rename action for an existing role card.
If a role name or description needs to change:
- Create a replacement role with the corrected name and description.
- Copy the intended permission set.
- Reassign users from the old role to the replacement role.
- Delete the old role after no users are assigned to it.
To delete a role:
- Find the role card.
- Select the delete icon.
- Review the Delete Role confirmation.
- Select Delete Role.
Built LMS blocks deletion while users are still assigned to the role.
Verify success
Role maintenance is complete when:
- The role name describes the user job.
- The selected permissions match the pages and actions required.
- Broad permissions are limited to trusted admin roles.
- Users are reassigned before old roles are deleted.
- A pilot user can test the role before broad rollout.
Troubleshooting
Reassign all users who currently have the role. Built LMS blocks deletion while any user profile still points to that role.
Confirm the related feature is enabled for the organization. Some permission areas are tied to enabled product areas or admin features.
The role may need the area's manage permission. For example, course publishing
and AI Update workflows use broader course management permissions.