So far, my JIRA 4.1 Deep Dives have covered the new user experience for tracking issues and using the operations bar, however, one of the most popular new features is the ability to customise email subject lines. At 224 votes, this issue had the most votes in the JIRA 4.1 change log.

Customisable JIRA emails

JIRA relies on the Apache Jakarta Velocity templating engine to render the email notifications it sends out. This easy to use templating engine lets you customise email content for both HTML and plain text emails.

Why change the subject?

The subject line of JIRA email notifications is set to display the email prefix (which is set in the Mail Server) followed by the subject line as defined by the template:
custom-email-subjects.png
By default, the subject line templates display the event type, issue key and issue summary by using the following syntax:

$eventTypeName: ($issue.key) $issue.summary


The two most common reasons for changing the email subject lines include:

  • Threaded emails – Many email clients group email messages with similar subject lines into threaded discussions or conversations. By removing the event type from the subject line, all JIRA notification emails will be grouped together regardless of the event type.
  • Additional fields – Many customers prefer to add custom fields, like priority or affected version, to the subject line for further grouping or filtering capabilities within their email client.

What information would you put in your subject lines? Drop a comment below to let us know how you have configured your JIRA emails.

Get JIRA 4.1 today

Download JIRA 4.1 now to upgrade or get started with a free 30-day trial. You can also check out our Online Trial (also free for 30 days) or play around with our live Sandbox which includes a guided tour of JIRA 4.1.

Fresh ideas, announcements, and inspiration for your team, delivered weekly.

Subscribe now

Fresh ideas, announcements, and inspiration for your team, delivered weekly.

Subscribe now