Creating Rosters
Define who’s on-call and when using independent, flexible rosters.
Prerequisites
- Access to a project where you want to create the roster
- Team members added to the project
1. Navigate to On-Call
- Open your project
- Navigate to On-Call in the sidebar
- Click New Roster
2. Configure Basic Settings
| Field | Description |
|---|---|
| Roster Name | A descriptive name (e.g., “Primary Engineering”, “Weekend Support”) |
| Timezone | The timezone for shift calculations (e.g., America/New_York) |
| Start Date | When the roster begins generating shifts |
| Start Time | The time of day shifts begin |
| End Date | Optional. When the roster stops generating shifts |
3. Configure Rotation Settings
Rotation Type
Choose how users rotate through shifts:
| Type | Description |
|---|---|
| Weekly Rotation | Users rotate positions each week, ensuring everyone experiences different days |
| Sequential | Users rotate in exact order (User A → User B → User C → User A) |
| Even Distribution | Shifts spread evenly across users, maximizing time between each user’s shifts |
Shift Duration
Set how long each shift lasts (1-24 hours). This affects how many shifts are generated per day when using Fill Gaps mode.
| Duration | Shifts Per Day (Fill Gaps) |
|---|---|
| 24 hours | 1 shift |
| 12 hours | 2 shifts |
| 8 hours | 3 shifts |
| 6 hours | 4 shifts |
Concurrent Users
Set how many users are on-call simultaneously for each shift (1-10 users).
- 1 user: Clear ownership, single point of contact
- 2+ users: Redundancy, shared workload, pair coverage
Coverage Mode
| Mode | Description |
|---|---|
| Fill Gaps | Generate multiple shifts per day to provide continuous 24-hour coverage |
| Single Shift | Generate exactly one shift per scheduled day |
Days of Week
Select which days the roster should generate shifts. By default, all days are selected.
4. Add Users
- In the Users section, click to add team members
- Select users from the dropdown (only project members appear)
- Drag to reorder users (order matters for sequential rotation)
- Add at least as many users as concurrent shifts
5. Save and Preview
- Click Save to create the roster
- Navigate to the Rosters view to see generated shifts
- Use the calendar view to verify coverage is correct
Result
The roster is now active and generating shifts based on your configuration. On-call users will receive alerts routed to them during their assigned shifts.
Example Configurations
24/7 Engineering Coverage
| Setting | Value |
|---|---|
| Rotation Type | Even Distribution |
| Shift Duration | 8 hours |
| Concurrent Users | 1 |
| Coverage | Fill Gaps |
| Days | All days |
Creates 3 shifts per day (8am-4pm, 4pm-12am, 12am-8am) rotating evenly across all users.
Business Hours Support
| Setting | Value |
|---|---|
| Rotation Type | Weekly Rotation |
| Shift Duration | 8 hours |
| Concurrent Users | 1 |
| Coverage | Single Shift |
| Days | Monday-Friday |
Creates one 8-hour shift on weekdays, rotating weekly.
Weekend Backup Team
| Setting | Value |
|---|---|
| Rotation Type | Sequential |
| Shift Duration | 12 hours |
| Concurrent Users | 2 |
| Coverage | Fill Gaps |
| Days | Saturday, Sunday |
Creates two 12-hour shifts on weekends with 2 people on each shift.
Related
- On-Call Overview - Understand the on-call system
- Shift Rotations - Rotation type details
- Time Zones - Timezone handling
- Substitutions - Override shifts temporarily