Notifications
Notifications keep staff informed about changes to items they own, watch, or approve.
Notification Types
| Value | Label | Description |
|---|---|---|
mentioned | Mentioned | When you are mentioned or tagged on an item. |
assigned | Assigned | When you are assigned as staff owner or approver. |
item_published | Item Published | When an agenda containing your items is published. |
comment_added | Comment Added | When a public comment is added to your item. |
deadline_approaching | Due date imminent | When a workflow step on an item you own is approaching its due date or has passed it. |
approval_requested | Approval Requested | When an item is submitted for your approval. |
approver_approved | Approver Approved | When an approver approves an item you watch, own, or approve. |
approver_rejected | Approver Blocked | When an approver blocks an item (advisory signal — flags concerns before publish). |
approval_step_advanced | Review Requested | When a routine step you're assigned to opens for approval. |
approval_completed | Item Fully Approved | When every approver has approved an item (ready to publish). |
sso_join_requested | Join Requests | When someone signs in via single sign-on without an invite and needs to be admitted. |
Who Gets Notified
Recipients are derived from their relationship to an item:
- Watchers — subscribed to updates on the item
- Staff owners — assigned as the item's staff owner
- Accountable staff — designated as accountable
- Approval chain — assigned to approval steps
You won't get duplicates — being both a watcher and the staff owner gets you one notification, not two.
The actor who triggers an event never receives the notification. If you publish an agenda containing your own items, you don't get notified about the publish.
Channels
- In-app — appears in the notification inbox
- Email — sent to the user's verified address
Preferences
Each user configures preferences per notification type, with independent toggles for in-app and email. Both default on.
Org admins can set org-wide defaults for users who haven't set their own. Order of precedence: your own preference, then the org default, then the event's audience rule.
Background Delivery
Notifications are sent in the background, usually within a few seconds. Failed deliveries (for example, a temporary email-provider error) are retried automatically.
Related
- Comments — comment activity is one of the triggers
- Approval Workflow — approval state changes notify the right people