Built LMS Help Center
Settings

Assign and Test Roles

Assign roles to users, invite users with roles, use common role patterns, and pilot-test access.

Use this guide after the role exists and you need to apply it to people.

Before you begin

You need:

  • Admin access to users and roles.
  • The role you want to assign.
  • One pilot user for testing.
  • The exact workflow the pilot user should be able to complete.
  • The pages and actions the pilot user should not be able to use.

Test with a pilot user before assigning a new or changed role broadly.

Assign roles to people

Role definitions do not assign themselves to users.

  1. Open Admin Dashboard > People > Users.
  2. Find the user.
  3. Open the user actions menu.
  4. Select Manage roles.
  5. Review Current Role.
  6. Choose a role under Select Role.
  7. Select Save Changes.

The role selector is single-choice. A user profile has one role at a time.

When inviting a user, choose the role during the invite flow if the invite form shows User Role.

Use common role patterns

Use these as starting points, then adjust for your organization:

Role patternTypical access
Course authoradmin:dashboard, course read/write, content read/write, and assessment or certificate read access when needed.
Learning program managerCourse, path, enrollment, and analytics access for program operations.
Reports viewerAnalytics read access, with own/team limits when supported.
User administratorUser, group, and enrollment access for account operations.
Integration administratorSettings, API, webhook, authentication, domain, and audit access where needed.
Billing or monetization administratorBilling read/manage and analytics access for commerce workflows.

Add delete, manage, or wildcard permissions only when the user should perform those broader actions.

Test a role safely

  1. Create or update the role.
  2. Assign it to one pilot user.
  3. Ask the pilot user to refresh the app or sign in again.
  4. Confirm the expected dashboard opens.
  5. Confirm each required page appears in navigation.
  6. Try the exact task: view, create, update, delete, publish, export, or manage.
  7. Confirm blocked pages are still blocked.
  8. Apply the role to the rest of the group only after the pilot test passes.

Permission changes can take a short time to appear for users who are already signed in. If the pilot user still sees old access after a refresh, have them sign out and sign back in.

Verify success

Role assignment is ready when:

  • The user has the intended role.
  • The expected dashboard opens.
  • The user can complete the intended workflow.
  • The user cannot access blocked pages or actions.
  • The role is assigned broadly only after the pilot test passes.

Troubleshooting

On this page