Notifications
How the notification centre works, what events trigger notifications, and how to control your delivery channels.
Overview
NIP keeps everyone informed about activity that affects them — request updates, workflow progress, team changes, and account events — through a built-in Notification Centre plus optional email delivery.
Notification Centre
Open /notifications (or click the bell icon in the top bar) to see your in-app notifications.
- Pagination — 25 notifications per page
- Unread badge — the bell icon shows the unread count and refreshes every 30 seconds
- Mark as read — clicking a notification marks it as read and navigates to the related resource
- Mark all as read — single bulk action at the top of the list
- Delete — remove a single notification (soft delete)
- Relative time — shows "Just now", "5m ago", "2h ago", "3d ago", or the full date for older items
Notification Types
Each notification carries a type that controls its icon and colour:
| Type | Colour | Used for |
|---|---|---|
| Approval | Green | Approvals, decisions, request status changes |
| Task | Amber | Task / workflow assignments needing your action |
| System | Blue | Account events, password changes, settings |
| Team | Purple | Team membership changes |
| Mention | Indigo | You were mentioned somewhere |
| Default | Gray | Anything that doesn't fit the categories above |
Email Notifications
In addition to in-app notifications, NIP sends emails for important events. You can enable or disable each trigger individually under Settings → Notifications (see Settings).
Available Email Triggers
Account & user events
- Account Created
- Account Suspended / Unsuspended
- Email Verification
- Login Success
- Password Changed
- Password Reset (link & OTP)
- Role Changed
- User Approved / Rejected
Request events
- Request Created
- Request Status Changed
- Request Assigned
Team & workflow events
- Team Assigned
- Team Member Added / Removed
- Step Assigned
- Workflow Step Status Changed
- Workflow Step Skipped
- Team Decision recorded
- Proposal Decision recorded
- Donor Meeting outcome
- Stakeholder Meeting completed
Delivery Channels
Three global channels are available; each user controls their own preferences:
| Channel | Default | Notes |
|---|---|---|
| On | Required for password reset & account events | |
| SMS | Off | Optional, used only when explicitly enabled |
| Push | On | Browser push notifications |
Action Navigation
Most notifications include a deep link. For example, a "Request Assigned" notification will navigate you to /requests?requestId=<id> with the relevant request drawer pre-opened.