Skip to main content

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:

ColumnDescription
NameDisplay name of the role
CodeIdentifier used in code
ProjectAssociated project
Auth CollectionThe collection this role belongs to
ActionEdit or delete the role

Creating a Role

  1. Click Add Role in the Roles tab

  2. Configure Basic Settings:

    • Name - Display name (e.g., "Administrator")
    • Code - Code identifier (e.g., "admin")
  3. Configure Advanced Settings (optional):

    • Add conditions that determine role membership
  4. Click Submit

Role Conditions

Advanced settings let you define conditions for role assignment:

FieldDescription
ConjunctionWHERE, AND, OR
Session FieldField from user session to check
Operatoris equal to, is not equal to, contains, etc.
Value InputValue 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