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.
- Open Admin Dashboard > People > Users.
- Find the user.
- Open the user actions menu.
- Select Manage roles.
- Review Current Role.
- Choose a role under Select Role.
- 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 pattern | Typical access |
|---|---|
| Course author | admin:dashboard, course read/write, content read/write, and assessment or certificate read access when needed. |
| Learning program manager | Course, path, enrollment, and analytics access for program operations. |
| Reports viewer | Analytics read access, with own/team limits when supported. |
| User administrator | User, group, and enrollment access for account operations. |
| Integration administrator | Settings, API, webhook, authentication, domain, and audit access where needed. |
| Billing or monetization administrator | Billing 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
- Create or update the role.
- Assign it to one pilot user.
- Ask the pilot user to refresh the app or sign in again.
- Confirm the expected dashboard opens.
- Confirm each required page appears in navigation.
- Try the exact task: view, create, update, delete, publish, export, or manage.
- Confirm blocked pages are still blocked.
- 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
Confirm the role exists in your organization, refresh the invite form, confirm you are working in the correct organization, and check whether the role was deleted or replaced.
Add analytics:manage if the user should export, schedule, or manage advanced
analytics. Keep analytics:read for users who only need to view reports.
Ask the user to refresh. If the old access remains, have the user sign out and sign back in.