Uploaded image for project: 'Jira Data Center'
  1. Jira Data Center
  2. JRASERVER-65718

Document how Mail Queue works, including how JIRA prioritizes notifications when more than one is triggered for the same user ( like in Edit issue)

    • 2
    • We collect Jira feedback from various sources, and we evaluate what we've collected when planning our product roadmap. To understand how this piece of feedback will be reviewed, see our Implementation of New Features Policy.

      When performing several changes in an issue through a screen (like the Edit screen), this might trigger several notifications at the same time for the same user, this notifications reach the Mail Queue and , at the time of flushing the mail queue, JIRA follows some unclear rules to create one consolidated notification containing all of them (it seems to appear as a new notification with an 'envelope' icon screenshot-1.png , but this is purely a conjecture and it might be just JIRA indicating that it is flushing the notifications one by one) using one of the notifications to be the 'title' (like 'Assigned' or 'Updated') but will also include all the other changes made in it.

      When multiple notifications for the same user are in the Mail Queue, by testing it seems the current behavior to choose the 'title' is:

      1. If an "Issue Assigned" is among the notifications, it is chosen to be the title.
      2. If there is no "Issue Assigned" notification, an "Issue updated" notification will be sent with all the changes.
      3. For some reason, if one of the changes made is Work logged added, it triggers a completely separate notification in adition to the "assigned" or "updated" notification, and might even contain changes that are alread included in them ( see example, the due date and assignee change ware included in both notifications screenshot-2.png)
      4. Comments added through a screen do not trigger the "Commented notification" nor are included in the list of changes made.

      The suggestion is to make a dedicated documentation page for the JIRA Mail Queue (as there is none to be found at the moment), including the rules and priorities for the notifications.

      Notes:

      • All the tests were done using the 'Reporter' as test subject. All changes to the issue were done by an admin user.
      • The test was done in clean JIRA Software Server 7.3.8 and 7.4.0.
      • Changing the order of the fields in the screen does not seem to affect the behavior.

        1. screenshot-1.png
          screenshot-1.png
          92 kB
        2. screenshot-2.png
          screenshot-2.png
          85 kB

            [JRASERVER-65718] Document how Mail Queue works, including how JIRA prioritizes notifications when more than one is triggered for the same user ( like in Edit issue)

            Atlassian Update - 24 March 2025

            Hello,

            Thank you for submitting this suggestion. We appreciate you taking the time to share your ideas for improving our products, as many features and functions come from valued customers such as yourself.

            Atlassian is committed to enhancing the security and compliance of our Data Center products, with an emphasis on sustainable scalability and improving the product experience for both administrators and end-users. We periodically review older suggestions to ensure we're focusing on the most relevant feedback. This suggestion is being closed due to a lack of engagement in the last four years, including no new watchers, votes, or comments. This inactivity suggests a low impact. Therefore, this suggestion is not in consideration for our future roadmap.

            Please note the comments on this thread are not being monitored.

            You can read more about our approach to highly voted suggestions here and how we prioritize what to implement here.

            To learn more about our recent investments in Jira Data Center, please check our public roadmap and our dashboards, which contain recently resolved issues, current work, and future plans.

            Kind regards,
            Jira Data Center

            Aakrity Tibrewal added a comment - Atlassian Update - 24 March 2025 Hello, Thank you for submitting this suggestion. We appreciate you taking the time to share your ideas for improving our products, as many features and functions come from valued customers such as yourself. Atlassian is committed to enhancing the security and compliance of our Data Center products, with an emphasis on sustainable scalability and improving the product experience for both administrators and end-users. We periodically review older suggestions to ensure we're focusing on the most relevant feedback. This suggestion is being closed due to a lack of engagement in the last four years , including no new watchers, votes, or comments. This inactivity suggests a low impact. Therefore, this suggestion is not in consideration for our future roadmap. Please note the comments on this thread are not being monitored. You can read more about our approach to highly voted suggestions here and how we prioritize what to implement here. To learn more about our recent investments in Jira Data Center, please check our public roadmap and our dashboards, which contain recently resolved issues , current work, and future plans. Kind regards, Jira Data Center

            Thanks matt.doar, I have update the description to indicate that the notification 'consolidation'/envelope icon is purely a conjecture.

            Rene C. [Atlassian Support] added a comment - Thanks matt.doar , I have update the description to indicate that the notification 'consolidation'/envelope icon is purely a conjecture.

            MattS added a comment -

            I created a request for documenting the whole Mail Queue, since the combining of prioritizations may actually come from how the underlying events are fired in different parts of JIRA, not specifically in the Mail Queue source code. I searched it and didn't find the functionality there, but may have missed it.

            MattS added a comment - I created a request for documenting the whole Mail Queue, since the combining of prioritizations may actually come from how the underlying events are fired in different parts of JIRA, not specifically in the Mail Queue source code. I searched it and didn't find the functionality there, but may have missed it.

            MattS added a comment - - edited

            In the 7.4.0 source file mailqueueadmin.jsp it appears that the envelope icon just means that the queue is in the middle of being sent. Nothing to do with consolidating notifications

                <ww:if test="mailQueue/sending == true">
                    <tbody>
                    <tr style="background-color:#<ww:if test="hasError == true">ffcccc</ww:if><ww:elseIf test="/mailSendingDisabled == true">ffdddd</ww:elseIf>">
                        <td>
                            <img src="<%= request.getContextPath() %>/images/icons/mail_small.gif" border="0" alt="<ww:text name="'admin.mailqueue.sending'"/>" title="<ww:text name="'admin.mailqueue.sending'"/>">
                            <ww:property value="/mailQueue/itemBeingSent/subject"/>
                        </td>
                        <td>
                            <ww:property value="/prettySendingStartTime"/>
                        </td>
                    </tr>
                    </tbody>
                </ww:if>
            

            MattS added a comment - - edited In the 7.4.0 source file mailqueueadmin.jsp it appears that the envelope icon just means that the queue is in the middle of being sent. Nothing to do with consolidating notifications <ww:if test="mailQueue/sending == true"> <tbody> <tr style="background-color:#<ww:if test="hasError == true">ffcccc</ww:if><ww:elseIf test="/mailSendingDisabled == true">ffdddd</ww:elseIf>"> <td> <img src="<%= request.getContextPath() %>/images/icons/mail_small.gif" border="0" alt="<ww:text name="'admin.mailqueue.sending'"/>" title="<ww:text name="'admin.mailqueue.sending'"/>"> <ww:property value="/mailQueue/itemBeingSent/subject"/> </td> <td> <ww:property value="/prettySendingStartTime"/> </td> </tr> </tbody> </ww:if>

              Unassigned Unassigned
              rchiquete Rene C. [Atlassian Support]
              Votes:
              3 Vote for this issue
              Watchers:
              4 Start watching this issue

                Created:
                Updated:
                Resolved: