Staff Roles
Backoffice path: backoffice/staff-roles
Available to roles: System Administrator, Administrator
Overview
Staff Roles let you create custom organizational positions like "Fleet Chief", "A320 Fleet Manager", or "Training Captain". Each role can have Bouncer abilities assigned, be scoped to specific fleets, and be assigned to users — granting those users all the role's permissions automatically.
Staff Roles are actual Bouncer roles under the hood, but they are separate from the built-in system roles (System Administrator, Administrator, Operations Staff). They are designed to be created and managed by your VA's admin team.
Creating a Staff Role
Navigate to Backoffice > Pilots & Career > Staff Roles and click Create.
| Field | Description |
|---|---|
| Name | The display name for the role (e.g. "Fleet Chief"). A URL-safe slug is generated automatically |
| Description | A short description of what this role entails |
| Color | A hex color code used for the role badge (e.g. #3B82F6) |
| Icon | A Heroicon name for display (e.g. shield-check) |
| Display Order | Controls the order in which roles appear on the public staff page. Lower numbers appear first |
| Public | Whether this role is visible on the public staff page and API |
After creation, you will be redirected to the edit page where you can configure abilities, assign users, and set fleet permissions.
Abilities
On the edit page, the Abilities section shows all available Bouncer abilities grouped by type. Select the abilities that users with this role should have.
When you save abilities:
- All assigned users immediately inherit the selected abilities
- Removing an ability immediately revokes it from all assigned users
Assigning Users
On the edit page, use the Assigned Users section to add or remove users from the role:
- Select a user from the dropdown
- Click Add
- The user will immediately inherit all abilities assigned to this role
When a user is removed from a role, all abilities granted through that role are automatically revoked.
Fleet Permissions
The Fleet Permissions section shows a checkbox grid of all fleets in your VA. Selecting a fleet grants the manage ability on that specific fleet to the role, and by extension, to all users assigned to the role.
When you save fleet permissions:
- All assigned users automatically gain manage access to the selected fleets
- Users can manage the selected fleets in the backoffice
Fleet permissions are additive. If a user holds multiple staff roles, they can manage all fleets from all their roles combined.
Public Staff Page
If a staff role has Public enabled, it appears on the public staff page at /staff. This page displays:
- Role name with color badge and icon
- Role description
- Member names and profile pictures
The public staff page is accessible to all authenticated users and appears in the sidebar under the Information section.
Public API
Public staff roles are also available via the Public API:
GET /api/public/staff
Returns an array of public staff roles with their members and fleet assignments.
How Permissions Work
Staff Roles are native Bouncer roles with abilities assigned at the role level:
- When abilities or fleets are assigned to a role, they are stored as Bouncer permissions on the role
- When a user is assigned a staff role, Bouncer automatically grants them all the role's abilities
- When roles or abilities change, all affected users are updated automatically
- Staff role permissions never conflict with system roles — a System Administrator always retains full access
Staff Roles do not replace the built-in system roles. They complement them by providing granular, customizable permissions that can be managed by your admin team without modifying the system role structure.