Built LMS Help Center
Settings

Roles and Permissions

Plan role access, create permission bundles, assign users, and test access safely.

Use Settings > Users & Access > Roles to control what each role can see and do in Built LMS.

Roles are permission bundles. A user receives access from the role assigned to their profile. The Roles page defines those bundles; user assignment happens from Admin Dashboard > People > Users.

Before you begin

You need admin access to manage roles and permissions.

Before changing a role, write down:

  • Which user job the role is for.
  • Which admin pages the user must open.
  • Which actions the user must take.
  • Whether the user needs the admin dashboard, manager dashboard, or learner-only experience.
  • Which current users have the role.

Do not edit a heavily used role until you know who depends on it. Create a test role or pilot role when you are changing access for a large group.

Choose the role task you need

Use the focused guide that matches the job:

  • Create and Maintain Roles to understand permissions, create roles, edit permission sets, replace roles, or delete roles.
  • Assign and Test Roles to assign roles to people, invite users with roles, build common role patterns, and pilot-test access.

Understand the permission model

Most permission names follow this pattern:

ActionWhat it usually allows
readView records, pages, or reports.
writeCreate or update records.
deleteRemove records.
manageUse broader admin actions such as publishing, exporting, scheduling, configuring, or bulk management.
ownWork with assigned or owned data only, where supported.
*Wildcard access for every action in that resource, when that permission exists.

Dashboard access has dedicated permissions:

PermissionUse
admin:dashboardAllows access to the admin dashboard shell.
manager:dashboardAllows access to the manager dashboard.

Treat each permission as explicit. If the user must both open a page and change data on it, include the read and write/manage permissions that page requires.

Verify success

Role changes are ready to roll out when:

  • The role includes the dashboard access the user needs.
  • The role includes read access for pages the user must open.
  • The role includes write, manage, export, publish, or delete permissions only where the user needs those actions.
  • A pilot user can complete the intended workflow.
  • The same pilot user is blocked from pages and actions they should not use.

Troubleshooting

On this page