User roles define what actions and access different types of users have within the platform. Administrators can create, modify, and manage roles to control permissions.
Overview
Role-based access control (RBAC) allows administrators to assign specific permissions to roles. Users are then assigned to roles, granting them the associated access levels.
How to Access
- Log in as an administrator
- Navigate to Users in the sidebar
- Click on Roles
- The roles management interface will open
Prerequisites
- Administrator role required
Step-by-Step Guide
Step 1: View Existing Roles
You will see a list of all roles with their display name, description, and user count.
Step 2: Create a New Role
Click Add Role. Enter a role name (e.g., Moderator, Editor) and an optional description explaining the role's purpose.
Step 3: Assign Permissions
Select the role and click Edit Permissions. A list of available permissions will appear. Check the permissions you want to grant to this role:
- View - Can see specific content
- Create - Can create new content
- Edit - Can modify existing content
- Delete - Can remove content
- Admin - Full administrative access
Step 4: Assign Users to Roles
Navigate to the Users section. Select a user and click Change Role. Select the desired role from the dropdown.
Step 5: Delete or Modify Roles
To delete a role, click the Delete button. Note: Users assigned to a deleted role will lose associated permissions. To modify a role, click Edit.
Default Roles
- Admin - Full access to all platform features
- User - Standard user with basic access
- Creator - For content creators with publishing capabilities
- Moderator - Can moderate content and manage reports
Troubleshooting
Issue: Cannot delete a system role
Solution: System roles (Admin, User) cannot be deleted. You can only modify their permissions.
Issue: User does not have expected permissions
Solution: Check that the user is assigned to the correct role. Users can only have one active role.
Quick Reference
| Route | admin.user_management.role.index |
| Permission | Admin only |
| Category | Getting Started |