First-Time Setup: Roster Builder Checklist
This checklist walks you through creating your first roster as a Roster Builder. Expect 1–2 hours depending on complexity.
Pre-Setup: What You Need to Know
Before starting, your Organization Admin should have already:
- ✅ Created streams (departments × shifts)
- ✅ Created craft groups (job roles)
- ✅ Added staff and assigned them to streams + craft groups
- ✅ Created master rosters (optional but helpful)
If not done, ask your admin to complete Admin Setup Checklist first.
Phase 1: Understand Your Organization (15 mins)
1. Review organization structure
- Confirm with your admin which Streams and Craft Groups you roster for
- Open Sidebar → Streams, Craft Groups, or Organizations → [your org] → Settings for org rules (rest hours, consecutive shifts, etc.)
- Ask admin if anything is unclear
✅ Checkpoint: You understand your org structure
2. Review staff & permissions
- Go to Sidebar → Clinician Staff (
/employees) - See which staff are in your stream(s) and craft groups
- Confirm your Roster Builder scope (which streams × craft groups you can edit)
✅ Checkpoint: You know who you're rostering
2b. Level 4 — availability vs leave (teach your staff)
Before building rosters, staff must use the right tool:
| Staff action | Where in the app | Your role |
|---|---|---|
| Preferences / "can't work Sundays" | My Availability | Review on Staff Availability grid (/staff-availability) |
| Holiday / sick leave | Leave Planner → Request Leave | Approve in Leave Planner (/leave) |
Common staff mistake: putting vacation in My Availability instead of Leave Planner. Redirect them to Availability vs Leave and the Staff Checklist.
✅ Checkpoint: You can explain the difference to staff
Phase 2: Understand Master Rosters (15 mins)
3. Review Master Roster (Level 3)
If your admin created a master roster template:
- Go to Sidebar → Master Roster (
/master-roster) - Select your stream
- Look at the 4-week pattern:
- Who typically works which days?
- Are there rotations? (different staff on different weeks)
- How is fairness distributed?
This is your baseline. Your actual roster builds from this.
✅ Checkpoint: You understand the master roster pattern
Phase 3: Create Your First Living Roster (1 hour)
4. Start Roster Generation (Level 5)
- Go to Sidebar → The Living Roster (
/roster) - Select your stream (e.g., "ED - Day")
- Select pay period dates (e.g., "July 1–28, 2026")
- Click Generate
Option A: Use IRIS AI (Recommended for First Time)
- Click Generate with IRIS
- IRIS will:
- Build from master roster baseline
- Apply My Availability preferences and approved leave (not the same thing)
- Balance fairness
- Flag conflicts
- Wait for generation (~1–5 mins)
- Review result (see Step 5)
Option B: Manual Assignment
- Use master roster as reference
- Drag staff to each shift
- Or use Excel-style bulk assign:
- Select multiple shifts
- Assign to one person or rotate
- Click Apply
Time: 30–60 mins for one stream
✅ Checkpoint: Roster drafted
5. Review Fairness (10 mins)
- Click Check Fairness
- Review:
- Pre-fairness: How fair is the raw roster?
- Post-fairness: After adjustments?
- Look for problems:
- Anyone severely over/under-rostered?
- Imbalanced weekend distribution?
- Someone with 10+ consecutive shifts?
- If fairness <75%:
- Make manual adjustments (swap staff between shifts)
- Or revert and regenerate with IRIS
✅ Checkpoint: Fairness reviewed and acceptable (>75%)
6. Review Compliance (5 mins)
- Click Check Compliance
- Look for red flags:
- Staff scheduled outside their availability?
- Rest hour violations?
- Scope mismatches (wrong craft group for shift)?
- Fix violations:
- Click the shift
- Reassign to correct staff or leave empty
- Click Save
✅ Checkpoint: No red compliance warnings
7. Make Final Tweaks (10–15 mins)
Before publishing, any last changes:
- Swap staff between shifts if needed
- Move staff to other shifts using right-click → Move Assignment (faster than delete + recreate)
- Add notes to shifts (e.g., "Sarah prefers mornings")
- Assign open shifts if any are uncovered
- Review with manager if unsure
✅ Checkpoint: Roster ready for publication
8. Publish Roster
- Click Publish
- Confirm pay period
- Click Publish to Staff
✅ Checkpoint: Roster published! Staff can now see shifts
Phase 4: Manage Published Roster (Ongoing)
After publication, your role changes. You now:
9. Approve leave & shift requests
Leave (formal time off):
- Go to Sidebar → Leave Planner (
/leave) - Review pending requests — approve, decline, or amend with reason
- Approved leave automatically blocks rostering on those dates
Shift swaps & open shifts:
- Go to Sidebar → Shift Deck → Approvals tab (
/shift-deck?tab=approvals) - For each swap or open-shift claim:
- Is the staff member eligible (craft group, scope, rest rules)?
- Any compliance issues?
- Approve or decline with reason
10. Manage open shifts
If someone is on approved leave or calls out sick:
- Sick / personal leave: record or approve leave in Leave Planner (may trigger open shifts automatically depending on org settings)
- Open shift on Living Roster: use Open Shifts panel or mark vacancy and broadcast
To fill an open shift:
- Staff bid via Shift Deck, or you assign directly on The Living Roster
- Select replacement staff and save
11. Use IRIS for Quick Solutions
If stuck (e.g., "I need an RN for Tuesday 3pm"):
- Click Ask IRIS
- Describe: "I need an RN for Tuesday ED 3–11pm, Sarah is out"
- IRIS suggests eligible staff
- Click Apply to assign
Phase 5: Prepare for Next Roster
12. Gather Feedback
Before creating the next roster:
- Ask staff: "How was the roster fairness?"
- Watch for patterns (is anyone always unhappy?)
- Note pain points for admin
13. Create Next Roster (Faster This Time)
- Apply Master Roster → Generate with IRIS → Fill Gaps → Roster Health → Publish
- Check Staff Availability grid for new preferences; check Leave Planner for new approved leave
- Audit fairness
- Publish
Success Checklist
After first roster:
- ✅ Roster published to staff
- ✅ All shifts covered (no major gaps)
- ✅ Fairness >75%
- ✅ No compliance violations
- ✅ Shift swaps working
- ✅ Staff feedback gathered
Common Mistakes to Avoid
❌ Publishing with low fairness (<75%): Staff complain
❌ Missing compliance violations: Creates safety issues
❌ Not communicating with staff: They panic if shifts change
❌ Using IRIS without review: Always check AI suggestions
❌ Ignoring swap requests: Backlog builds up
Quick Reference
| Task | Steps | Time |
|---|---|---|
| Generate roster with IRIS | Living Roster → Generate with IRIS → Review | 10 mins |
| Review staff availability | Staff Availability grid | 5 mins |
| Approve leave | Leave Planner → Review → Approve/Decline | 2 mins |
| Check fairness | Living Roster → Fairness view or Intelligence Hub | 5 mins |
| Check compliance | Living Roster → Roster Health | 5 mins |
| Approve swap / open shift | Shift Deck → Approvals | 2 mins |
| Handle call-out | Leave Planner + Living Roster reassignment | 5 mins |
| Ask IRIS for help | Living Roster → Generate with IRIS / IRIS chat | 5 mins |
Next Steps
- ✅ Create first roster
- ✅ Publish to staff
- ✅ Manage swaps + opens for 1 pay period
- ✅ Gather feedback
- ✅ Create second roster (faster!)
- ✅ Read detailed Level 5 guide for advanced features
Need Help?
- 📖 Read Level 5: Admin & Roster Builder Guide for detailed workflows
- 📖 Read Level 1–4 Admin Guides to understand the full system
- 💬 Ask your Organization Admin
- 📞 Submit support ticket for technical issues