Troubleshoot email notifications in Jira Service Management

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform Notice: Server and Data Center Only - This article only applies to Atlassian products on the server and data center platforms.

Purpose

This article details how to troubleshoot email notifications in Jira Service Management. Specifically it is primarily targeted at why they may not be getting sent to Jira Service Management customers.

Background

Notifications in Jira Service Management projects operate differently from notifications sent in Jira Core or Software. Specifically, Jira Service Management requests are Jira issues that:

  1. Are in a Jira Service Management enabled project.
  2. Have a valid Customer Request Type (or Request Type / Service Management Request Type).

Issues that do not meet both criteria are not Jira Service Management requests. They are regular Jira issues and not affected by the Jira Service Management notification system.

Regular Jira issues (those that do not meet the criteria above) will default to the Jira Project Notification Scheme. In this case, any users that are Jira Service Management Customers will not receive notifications, as they are not considered to be regular Jira users.

Jira Service Management Notification Scheme

Issues that are affected by the Service Management notification system will have altered notifications to the reporter/customer.

  • Notifications to the reporter/participants/customers will be sent according to the "Events triggering notification to customer" noted below.
  • Notifications to users other than the reporter/participants/customers will be sent according to the project's notification scheme.
  • Notifications to the reporter/participants/customers will always be HTML or plain text as detailed in Configuring service project notifications.

Requirements for Jira Service Management emails to be sent to customers:

System

Issue

  • In Jira Service Management project
  • Contains valid customer request type

User

  • Is the reporter or a participant of the issue
  • Has a valid email address

Issue Events

The events that trigger notifications differ depending on the version of Jira Service Management that you are running. See the Configuring service project notifications page for your version of Service Management.

Solution

If the answer to the question is 'Yes', continue, otherwise follow the instructions in the 'No' column.

QuestionNo
Is this a valid Jira Service Management request (Service Management project / request type)?
  • Make sure the issue is in a project that is configured to be a Service Management
  • Make sure the "Customer Request Type" field is populated

Can the customer can see the request under "My Requests" in the customer portal?

  • Check the customer is a reporter or participant of the issue.
Do you know if Jira mail is fully configured?
  • Check the outgoing mail server is enabled and working.
  • Verify if email has been disabled system wide.
Are Jira Service Management notifications enabled?
Is the user a participant or reporter of the issue?
  • Add the customer as a participant to the issue.
Does the reporter have a valid email assigned to their user?
  • Check their user has an email set, if not add one.
Have you performed any testing on the mail address?
  • Try sending a test mail to the user through Jira (in Outgoing Mail > Send a Test Email), to see if an error is returned.
  • Try sending them an email outside of Jira, using a separate mail account.
Have you checked the logs?
  • Enable the Outgoing Mail log in Administration > System > Troubleshooting and Support > Logging and Profiling and set it to DEBUG.

  • Reproduce the problem.
  • Check the atlassian-jira-outgoing-mail.log for any errors.
Have you investigated the mail server?
  • Check the mail server logs for any errors - this may require consulting with the Sys Admin / hosting provider.
  • Verify the mail server can send emails to those user accounts - you could configure another client to use it (such as Windows Outlook or Apple Mail) and try to send mails to those addresses.
  • Check if certain domains work or do not work - for example the SMTP may have blocked certain Hotmail, Yahoo and/or Gmail addresses.
Are you having issues sending out notifications only for the Resolved and Reopened actions ?


An error may be returned by the address.



DescriptionThis article details how to troubleshoot email notifications in Jira Service Management. Specifically, it is primarily targeted at why they may not be getting sent to Jira Service Management customers.
ProductJira
PlatformServer


Last modified on Nov 23, 2020

Was this helpful?

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