📖 Browse Documentation

Configure First Notifications

📋 Before You Start: Make sure you've completed the previous guide: Connect Discord Server

Let's create your first notification rule the easiest way: from the Global Settings page.

Open Global Notifications

  1. Go to Jira Settings → Apps → Discord for Jira → General Settings.
  2. Open the Notifications tab.
  3. Click Configure Notifications.
Add your first rule from the Global Settings › Notifications tab
Add your first rule from the Global Settings › Notifications tab

💡 Quick tip: Creating your first rule globally is faster, and you can still target a single project in the rule.

Add Rule Name

  1. Rule name - something clear like "Bug Alerts".
Pick a project or apply to all enabled projects; optionally add JQL
Pick a project or apply to all enabled projects; optionally add JQL

Choose What to Monitor

  1. Select project - choose one project or All Enabled Projects.
  2. JQL filter - leave empty for all issues, or add a simple filter (e.g., issuetype = Bug).
Pick a project and optional JQL filter
Pick a project and optional JQL filter

Pick Where to Send

  1. Confirm the Discord Server.
  2. Pick the Discord Channel where the bot should post.
  3. Open Advanced Delivery Options (optional) and consider enabling Send notifications to Discord threads to keep channels tidy.
Choose the destination server and channel
Choose the destination server and channel

Set When to Notify

Start simple. Recommended first setup:

  • Issue is: Created, Updated
  • Comment is: Created
  • Advanced Trigger Options: leave default
Pick issue/comment triggers, tracked fields, and status transitions
Pick issue/comment triggers, tracked fields, and status transitions

Choose Message Content

Add a few useful fields to the message. Suggested starters (Software projects):

  • ✏️ Description
  • 🔄 Status
  • 🎯 Priority
  • 🙋 Assignee
  • 📋 Project
  • For comment notifications: 💬 Comment Text, 📋 Project

Service Desk projects can also show: 🎫 Request Type, 🧵 Ticket Thread (recommended).

Formatting Options (recommended ON for most teams):

  • Show images in notifications
  • Show only changed fields
  • Mention Discord users when mentioned in Jira
  • Show change type emojis

📘 Need more fields? The full 16+ field list is documented in Configure Notifications.

Select a few helpful fields for clear, compact messages
Select a few helpful fields for clear, compact messages

Enable Quick Actions (optional)

Pick buttons to show on notifications:

  • Software: 💬 Add Comment, 🙋 Assign to me, 🔄 Change Status
  • Service Management: 🗨️ Reply to Customer, 💬 Add Internal Comment, 🙋 Assign to me, 🔄 Change Status

📚 For details and permissions, see Work with Issues.

Save and Test

  1. Click Create Rule.
  2. Create a test issue or add a comment in Jira.
  3. Check your Discord channel - you should see the notification 🎉
Verify your first notification in Discord
Verify your first notification in Discord

Manage Rules

  • Duplicate existing rules to speed up setup.
  • Enable/Disable rules without deleting them.

For all options and advanced settings, see Configure Notifications.

Quick Troubleshooting

🤔 No message in Discord? Ensure the bot can post in the selected channel.

🤔 Nothing triggers? Your JQL might be too strict - test it in Jira first.

Need more help? Visit Troubleshooting Notifications or say hi on our Community.