Creating User Roles
Required Permission
This feature requires the TEAM_ADMIN_USER_ROLES permission.
Learn how to create new User Roles to define permission sets for your team members.
Creating a New Role
- Navigate to Admin → User Roles
- Click the Create Role button
- Fill in the basic information:
- Role Name (required) - A descriptive name like "Sales Representative"
- Description - Explain the purpose of this role
- Click Save to create the role
After Creating a Role
Once created, you'll be taken to the role detail page where you can configure:
- Users - Assign users to this role
- Feature Permissions - Enable admin feature access
- Collection Permissions - Configure data collection access
- Wizard Permissions - Grant access to Data Wizards
Assigning Users
In the role detail page:
- Find the Users field
- Search for and select users to assign
- Note: Team Admins are excluded since they already have full access
Best Practices
- Start restrictive - Begin with minimal permissions, add more as needed
- Use descriptive names - Future you will thank you
- Document purpose - Use the description field to explain the role
- Group by function - Create roles based on job responsibilities, not individuals
Multiple Roles
Users can have multiple roles assigned. Their effective permissions are the combination (union) of all their roles. If any role grants a permission, the user has that permission.