Built LMS Help Center
Settings

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

  1. Open Admin Dashboard.
  2. Go to Settings.
  3. Open Users & Access.
  4. 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:

  1. Select Create Role.
  2. Enter Role Name.
  3. Enter Description.
  4. Expand each permission category you need.
  5. Select individual permissions, or select a category checkbox.
  6. Review the selected permission count.
  7. Select Create Role.

To edit permissions:

  1. Find the role card.
  2. Select Edit Permissions.
  3. Expand the permission categories.
  4. Select or clear permissions.
  5. Check the permissions selected count.
  6. 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:

  1. Create a replacement role with the corrected name and description.
  2. Copy the intended permission set.
  3. Reassign users from the old role to the replacement role.
  4. Delete the old role after no users are assigned to it.

To delete a role:

  1. Find the role card.
  2. Select the delete icon.
  3. Review the Delete Role confirmation.
  4. 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

On this page