Notification rules

Who this is for: Tenant owner, Admin
What you'll achieve: Control who is notified — and how — when the duty board changes

Requires role

notify.configure — Tenant owner or Admin

Before you begin

• School setup should be underway so publishes will fire real events
• Decide which events matter for duty leads vs all staff

Open rules

1. Open Notifications.
2. Scroll to Notification rules (below the inbox).
3. Select Add rule or Edit on an existing rule.

Default rules are seeded for new tenants — review them before go-live.

Triggers

Trigger	When it fires
Day published	A duty day goes live
Same-day change	Cover is recomputed after an absence or roster change
Hard gap	A published day still has unfilled slots
Last resort used	Leadership or last-resort staff are placed on duty

Audience

Combine:

• Staff on duty (assignees)
• Role checkboxes: Duty leads, Admins, Owners, Office staff, All staff (role)

Channels

Channel	Behaviour
In-app	Appears in the Notifications inbox
Email	Sent via the configured email provider (EMAIL_PROVIDER; console in local dev)

Priority

• Normal — informational
• High — requires acknowledgement in the inbox

Message templates

Select Manage templates to edit subjects and bodies.

Merge fields:

Field	Replaced with
	Recipient / staff display name
	Duty date
	Link to the day board
	Context for the change

See Notification merge fields.

What happens next

• Notifications inbox
• Today board — publish

Troubleshooting

Problem	What to try
Inbox empty after publish	Confirm a rule exists for Day published with in-app channel
No emails in local dev	Check console output — EMAIL_PROVIDER=console logs instead of sending
Cannot edit rules	Need Admin / Owner with notify.configure