Configuring email notifications

Jira can send email notifications to users when significant events occur. For example, when an issue is created or completed, or when any issue fields are updated.

Users can receive batched notifications for multiple issue updates or separate notifications for each update. Jira also sends separate emails when a user is created, during a password reset, and in similar cases. Learn more about different types of email notifications

For all of the following procedures, you must be logged in as a user with the Jira Administrators global permission.

How email notifications work in Jira

Issue updates

You will receive a separate email for every issue that’s been updated. The email contains events that occurred in an issue in the specified time frame (for example, the last hour). It also includes the following updates:

  • Details about the issue (if it was just created)
  • Changes to any of the issue fields (including custom fields)
  • Comments
  • Work logs
  • Attachments
  • Mentions

You can change the frequency of batching these notifications. Depending on your choice, you’ll receive an email with events from the last few minutes or an hour. Learn how to check the frequency of batched notifications

Mentions

When you're mentioned in an issue, it usually means that somebody needs your immediate attention. To avoid sending too many emails, a mention will be included in the email with other issue updates, but it will trigger this email to be sent as soon as possible (regardless of the frequency you've chosen). 

Customer notifications in Jira Service Management

Jira Service Management has an additional set of notifications, which we call customer notifications.

These notifications are designed to keep the customers informed about progress on particular tickets without disclosing information about internal processes, and usually include responses to customers, customer-visible changes, approvals, or requests being shared with individuals or organizations. 

Check out this guide for more information: Managing Jira Service Management notifications.

These notifications are not managed by Jira email batching and are not configurable. However, they are batched within the notification triggers. It means, when the customers update in quick succession, the notifications are batched in one mail.

Custom fields in notifications

Updates to custom fields in your issues are included in the notifications, just like regular fields. However, if you’re an advanced Jira user, you can display additional custom fields in your emails. Such custom fields can be added to email’s subject, header, or any other location.

Some of our users do this to describe their notifications more precisely, for example by adding security levels.

Learn more about adding custom fields to emails

Enabling notifications

To start the notifications flowing, you'll need to set up an SMTP mail server and create a notification scheme where you choose the notifications you'd like to get:

Jira sends email notifications based on default email templates.

You can customize the content and appearance of those templates, as well as configure the email address from which notifications are sent: Customizing email content, Configuring a project's email address.

Configuring batched notifications

Every team works in a different way, so we’re giving you a way to tailor the notifications to your needs. If you like to always stay on top of things, you can receive batched notifications every few minutes (2 minutes being the minimum). If you’d like to just read a summary every now and then, you can choose to receive a summary of what happened in the last hour.

tip/resting Created with Sketch.

You can also use the gg keyboard shortcut and search for the Batching email notifications setting.

Change the frequency of batched notifications

  1. In the upper-right corner of the screen, select Administration > System.
  2. Under Mail, select Batching email notifications.

  3. Choose the frequency that works for you.
  4. Save your changes.

These settings will be applied to all users.

Disable batched notifications

If you absolutely love to know what’s going on in your projects, you can also disable batched notifications and get notified about every event (for example, change of status or any of the fields) in a separate email.

You can choose to do this if you simply got used to separate notifications that were the default notifications before Jira 8.4.

To disable batched notifications:

  1. In the upper-right corner of the screen, select Administration > System.
  2. Under Mail, select Batching email notifications.

  3. Select Disabled.

  4. Save your changes.

These settings will be applied to all users.

Customizing email content

Email notifications are based on Apache’s Velocity templates. Whether it’s adding some info to the header or footer, or shuffling around the contents of your emails, you can make a number of customizations to the templates and tailor the emails to your needs.

Learn how to customize email content

Configuring a project's email address 

You can configure an email address for your project, which will work as the address that notifications are sent from the "sender address". This email address will also serve as the reply address for responses.

This setting is specific to the selected project and won’t affect the configuration of other projects or the default "sender address" of your SMTP mail server.

To configure a project’s email address:

  1. In the upper-right corner of the screen, select Administration > Projects.
  2. Select Notifications.
  3. Click the pen icon next to the email address.
  4. Enter a valid email address and select Update.

Notifications about issues from this project will now be sent from the new email address. If you ever wanted to change it back to the default address from your SMTP server, complete the same steps but leave the email address blank.

Email recipients

For each notification, Jira will only send the first encountered email intended for a recipient. Hence, if a user is included in two or more recipient lists (for example, the Project Lead and current reporter) for one event notification, the user will only receive the first encountered email notification. Jira will log the fact that this user was on multiple recipient lists.

Jira's default setting is to not notify users of their own changes. This can be changed on a per user basis via their profile preferences.

Specifying email format: HTML or text

Each Jira user can specify in their profile preferences, whether to send outgoing emails in text or HTML format. 

Jira administrators can specify a default email format by modifying the default user preferences. Learn more about configuring the default user settings

The HTML email format can accommodate internationalized words in the Issue Details section. Due to internet security settings, which prevent images from being automatically downloaded, the HTML email messages may not be correctly formatted.

For example, the summary column on the left may appear too wide. You can correct the formatting by accepting to download these images (this option should be available in the email). 

Troubleshooting notifications

You can use Jira admin helper to diagnose why a user isn't receiving email notifications when they should be or why a user is receiving email notifications when they shouldn't be. This tool is only available to Jira administrators.

To diagnose why a user is or is not receiving notifications for an issue:

  1. View the issue in Jira.

  2. Select Admin > Notification Helper.

  3. Enter the username of the user.

  4. Select Submit.

tip/resting Created with Sketch.

You can also access the Notifications Helper by going to Administration  > System > Notification Helper.

Last modified on Oct 12, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.