📖 Browse Documentation

Guides

Reference

🛟 Help Center
🔒 Trust Center

Get Notifications in Discord

Get automatic Discord notifications when pages and tasks are created or updated in Notion.

Before You Begin

📋 Prerequisites
  1. Database sharing: Share database with NotiCord in Notion (Add connections → NotiCord). Without this, database won't appear in dropdown when creating rules.
    ✅ Already shared during setup? You're good to go!
  2. Discord permissions: Bot needs these permissions in target channels: View Channel, Send Messages, Embed Links, and Attach Files. Without these, notifications will fail to post.

Step-by-Step: Create Your First Rule

  1. Go to the Notifications page

  2. Click "+ New Rule" button

  3. Select Notion database to watch

  4. Select Discord channel for notifications

  5. Choose event type:

    • Task Created / Page Created - Notify when new items are created
    • Task Updated / Page Updated - Notify when existing items change

    Event names depend on your database type → Learn more

  6. For Updated events: Select properties to watch, optionally filter by status (task databases only) → Property watching reference

  7. (Task databases only) Configure quick action buttons to allow status changes and self-assignment → Quick actions guide

  8. (Optional) Select fields to display in Discord notifications

  9. Click "Create Rule"

Test it: Create a new page in your Notion database - the notification should arrive in Discord within a few minutes.

⏱️ Important: Notification Timing
Notifications typically arrive within around 1 minute (or faster), but can take up to 5 minutes (sometimes longer). This is how Notion's webhook system works - it batches rapid changes to avoid overwhelming your Discord channel. If a notification doesn't appear after 5 minutes, check the Notifications page for delivery status.

What You'll See

📬 Notification Contents
  • Notification message (e.g., "New task created")
  • Page title (with link or plain text)
  • Page content (if enabled - includes @mentions when users have linked accounts)
  • Database properties (if selected - Status, Assignee, Due Date, Priority, etc.)
  • Quick action buttons (task databases only, if enabled)

Common Scenarios

Scenario Event Watch/Filter Quick Actions Result
New Task Inbox Task Created N/A Status + Assign All new tasks → #task-inbox with buttons
Completion Alerts Task Updated Status → Done None Status changes to Done → #wins (read-only)
Blocker Alerts Task Updated Status, Priority → Blocked Status + Assign Blocked tasks → #urgent with buttons
Documentation Updates Page Created N/A N/A New doc pages → #docs (read-only)
Multi-Channel Fan-Out Task Created N/A Mixed One event → multiple channels

Troubleshooting

Not receiving notifications? See the Notifications Not Working troubleshooting guide for common problems and solutions.