Ready for advanced control? This guide walks through every section of a notification rule (in the same order and names as the UI), including new options from the redesign. If you’re just getting started, see Configure First Notifications.
Before you start
- ✅ You have Jira admin or project admin rights
- ✅ You have connected your Discord server in General Settings
- ✅ The target Jira project is enabled for Discord
🛡️ Admin tip: You can create and manage rules from the Global Settings page to cover many projects at once. Use All Enabled Projects for instance-wide rules; create project-specific rules for exceptions.
Basic Information
- Rule name: Only used for identification.
What to Monitor
- Select project: Choose a single project or pick All Enabled Projects.
- JQL filter: Narrow which issues can trigger this rule. Test your JQL in Jira first.
💡 Quick tip: Keep JQL simple at first (e.g.,
issuetype = Bug
), then refine.
Looking for examples and recipes? See JQL Filters for Notifications.
Where to Send
- Discord Server and Discord Channel: Destination of notifications.
- Advanced Delivery Options:
- Send notifications to Discord threads: Optional setting (default: Off) that keeps channels tidy by posting follow-up updates inside an issue‑named thread.
- Known limitations: Threads are created on the first message for an issue; bot needs permission to create/post in threads.
- Send notifications to Discord threads: Optional setting (default: Off) that keeps channels tidy by posting follow-up updates inside an issue‑named thread.
💬 Learn more: See Discuss Jira Issues on Discord for manual threads and auto-threads behavior.
- Additional Discord role mentions: Always mention selected roles on messages.
When to Notify
- Issue is: Select events (Created, Updated).
- Comment is: Select events (Created).
- Advanced trigger options: Extra conditions for when to fire.
- Field changes: Only notify when specific fields change (e.g., 📝 Summary, 🎯 Priority, 🙋 Assignee, 🔄 Status).
- Status transitions: Only notify for selected status changes.
Message Content
Configure what’s included in Discord messages.
Fields to display in issue notifications (full list)
- For Jira Software projects:
- 📦 Issue Type
- 🔄 Status
- 🙋 Assignee
- 🕵️♂️ Reporter
- 🔗 Parent Issue
- 📋 Project
- 🏃♂️ Sprint
- 📅 Due Date
- 🛠️ Fix Versions
- 🧩 Components
- 🏷️ Labels
- 📎 Attachments
- 🎯 Priority
- ✏️ Description
- Additional fields for Jira Service Management projects:
- 🎫 Request Type
- 🧵 Ticket Thread
Fields to display in comment notifications
- For Jira Software projects:
- 💬 Comment Text
- 📋 Project
- 📎 Attachments
- Additional field for Jira Service Management projects:
- 🧵 Ticket Thread
Formatting Options
- Show images in notifications (default: On): Display inline images when available.
- Show only changed fields (default: On): Only list fields whose values actually changed. Per‑rule toggle.
- Mention Discord users when mentioned in Jira (default: On): Convert Jira @mentions to Discord pings for connected users.
- Requires users to have linked their Discord and Jira accounts; unlinked users won’t be pinged.
- Show change type emojis (default: On): Add visual emojis in titles for changes (e.g., 📝 summary, 🎯 priority, 🙋 assignee, 🔄 status).
Quick Actions (optional)
Add buttons to act directly from Discord messages.
- Software projects: 💬 Add Comment, 🙋 Assign to me, 🔄 Change Status.
- Service Management: 🗨️ Reply to Customer, 💬 Add Internal Comment, 🙋 Assign to me, 🔄 Change Status.
Comment action buttons:
- Software projects: 💬 Reply.
- Service Management: 🗨️ Reply to Customer, 💬 Add Internal Comment.
📚 See the dedicated guide: Work with Issues for details and required permissions.
🔐 Actions run as the clicking user and require their Jira permissions (Assign Issues, Add Comments, Transition Issues; plus Service Management comment permissions where applicable).
Manage Rules
- On the notifications list, click the ⋯ (three dots) menu next to a rule to:
- Duplicate a rule to reuse configuration.
- Enable/Disable a rule without deleting it.
- Delete to remove it.
Tips to Keep Noise Low
- Start with a few triggers and fields.
- Prefer “Show only changed fields” for update-heavy projects.
- Use role mentions sparingly.
🔍 Field visibility: A field will show only if it exists on the issue type and your Jira permissions allow viewing it.
Have questions? Join our Community.