πŸ“– Browse Documentation

Real-time Notification Rules

Complete reference for configuring notification rules - the routing instructions that control when Notion updates appear in Discord channels.

πŸ“– New to Notifications?

This is a comprehensive reference for all notification rule options. If you're setting up notifications for the first time, start with the Get Notifications in Discord guide for step-by-step instructions.


Rule Anatomy

Every rule has three core components:

  1. Source - Which Notion database or page to watch
  2. Target - Which Discord channel to post to
  3. Trigger - When to send notifications (created or updated)

Source Types

NotiCord supports two source types:

Database Sources

Watch pages inside a Notion database (including task databases). Database rules support:

  • Property-based filters (select properties to narrow, or leave empty for all)
  • Status filters (databases with a Status property)
  • Quick action buttons (task databases only)

Page Sources (Standalone Pages)

Watch a single page that is not part of a database. Page rules can also include subpages:

  • Subpages: Choose None (only this page), Direct children, or All descendants.
  • Created events: Require Direct children or All descendants (the selected page already exists).

Event Types

NotiCord supports two event types: Created (new items/subpages) and Updated (changes to existing items).

  • You can select one or both (default: both).
  • For standalone page rules, Created means a new subpage under the selected page (requires Direct children or All descendants).
πŸ“‹ Task vs Page Databases
Task Database: Has Status property + connected on Tasks page. Supports quick actions, slash commands, custom modal fields.
Page Database: Any database not connected on Tasks. Notifications only (read-only). Status filters still work if the database has a Status property.
β†’ Task Database Configuration for complete details

Created Events

Triggers when new items are created.

  • Database rules: Fires when a new database item is created.
  • Page rules: Fires when a new subpage is created under the selected page (requires Direct children or All descendants).

Updated Events

Triggers when content and/or properties change. Configuration required:

  • Update Types - Choose Properties, Content, or both
  • Property Filters (database rules only) - Select properties to narrow, or leave empty for all properties
  • Status Filter (optional, databases with a Status property) - Filter to specific status values
  • Quick Actions (optional, task databases only) - Add interactive buttons
⏱️ Batching Delay
Notion batches updates, causing 1-minute delays. Property updates follow your property filters, and content updates follow the content toggle.

Update Types

Choose what counts as an update for Updated rules:

  • Title (page rules only) - Page title changes.
  • Property changes (database rules only) - Fields like Status, Tags, or Title.
    • Select properties to narrow updates, or leave empty to watch all properties.
  • Content - Changes to page body blocks and text. No property filters apply.

Property Filters (Database Rules)

When Properties is selected for a database rule, you can optionally select specific properties:

  • No selection - Notify on any property change.
  • Selected properties - Only notify when those properties change.
πŸ“Œ Supported Properties
All Notion property types supported: Status, Assignee, Date, Select, Multi-select, Text, Number, Checkbox, People, URL, Email, Files, Relation, Rollup
⏱️ Formula updates
Formula-only recalculations do not trigger Notion update events. Formula properties can be displayed, but they won't trigger notifications unless another property changes. If you need time-based formula alerts (like "Due in 24h"), use Scheduled Alerts instead.

Triggers: Value changes (A→B), set (empty→value), cleared (value→empty)

Doesn't trigger: Content-only edits unless Content updates are enabled


Status Filter

Available for any database with a Status property. Requires Updated events with Properties updates enabled and the Status property selected.

βš™οΈ Configuration
Empty: Notify on all status changes
Selected values: Only notify when status changes to selected values (e.g., "Done", "Blocked")

Use cases: Alert on completion (filter to "Done"), flag blockers (filter to "Blocked", "At Risk"), track review stage (filter to "In Review", "Ready for QA")


Quick Action Buttons

Task databases only - Configure per notification rule:

  • Status change buttons - Show buttons for all database status values
  • Assign to me button - Show self-assign button (requires mapped Assignee property)

Buttons are configured separately for notification rules vs task creation confirmations. β†’ Quick Actions Guide for setup and button behavior details


Field Selection

Choose which properties appear in Discord notifications.

πŸ“ Available Fields
Standard fields:
  • Notification message (e.g., "New task created")
  • Page title (with link OR plain text)
  • Page content (includes Discord @mentions when enabled and users have linked accounts)
Database properties: All properties from your database (Status, Assignee, Due Date, Priority, Category, Tags, etc.)

Properties display as "Name: Value" with appropriate formatting for dates, people, and select fields.

Standalone page rules only offer the standard fields (no database property list).


Discord Mentions

Each rule includes a Discord mentions toggle (enabled by default) that controls whether Discord pings are sent.

  • When enabled: Linked users render as Discord @mentions in page content and people properties and will be pinged.
  • When disabled: Linked users still render as @mentions, but pings are suppressed.
  • Excludes the author: The person who triggered the change is never pinged.
πŸ”— Linked Accounts Required

Only users who have linked their Discord and Notion accounts render as @mentions. Everyone else stays as a display name.


Fan-Out Behavior

Multiple rules matching the same source and event will post to multiple Discord channels. Each Discord post counts separately toward your monthly quota.

Example: Created event with rules for #product-updates and #general β†’ posts to both channels

Alternative: Use Discord's native channel following to broadcast from one channel instead of creating multiple rules


πŸ’¬ Need Help?

See Notifications Not Working troubleshooting guide

Support