Collection Roles
The Roles tab within an Auth Collection allows you to manage roles specific to that collection. For a project-wide view and management of all roles, see the Centralized Roles section.
Centralized Management
While you can manage roles here, the Studio Roles page in the top navigation provides a unified interface for all roles across every auth collection.
Roles Table
The roles table displays:
| Column | Description |
|---|---|
| Name | Display name of the role |
| Code | Identifier used in code |
| Project | Associated project |
| Auth Collection | The collection this role belongs to |
| Action | Edit or delete the role |
Creating a Role
-
Click Add Role in the Roles tab
-
Configure Basic Settings:
- Name - Display name (e.g., "Administrator")
- Code - Code identifier (e.g., "admin")
-
Configure Advanced Settings (optional):
- Add conditions that determine role membership
-
Click Submit
Role Conditions
Advanced settings let you define conditions for role assignment:
| Field | Description |
|---|---|
| Conjunction | WHERE, AND, OR |
| Session Field | Field from user session to check |
| Operator | is equal to, is not equal to, contains, etc. |
| Value Input | Value to compare against |
Example: A role with condition WHERE role is equal to admin means users with "admin" as their role value get this role.
Common Roles
- Admin - Full access to all features
- User - Standard user access
- Viewer - Read-only access
- Manager - Access to specific modules
Next Steps
- Centralized Roles — Manage all roles from a single view
- Profile & Session — Manage user profiles and session fields
- Register Form — Configure user registration
- Auth Overview — Back to auth collections overview