How to add epic name to mail notification?

Hi there.

I receive issues mail notifications without epic name included. Is it possible to add epic name to my mail notification? (With html, I guess)

Thank you.


3 answers

There are two ways to do it: Modify the JIRA email templates, which requires server access and knowledge of velocity, or you can use an addon and customize your notifications in the JIRA interface. 

I would recommend Notification Assistant for a light-weight easy to use add-on, see:

Or if you want a more comprehensive control over everything mailrelated, check out JEMH:


     I was able to add the epic name to e-mails by modifying the templates which does require server access.  Additionally, this article explains how to configure JIRA to avoid the necessity of restarting to make the changes take effect during testing,  One thing I did was to create a custom.vm file that puts the custom information in the e-mail, see the code below.  I stored the custom.vm file in the 'includes' directory then I modified my other templates to parse this file, e.g. #parse("templates/email/includes/custom.vm").  This allows me to make changes in one place and I can insert the parse directive where ever I want the information to appear.  I am using the text templates so this is fairly simple but the e-mail formatting can be tedious.  I also modified the subject template, e.g. 'issuementioned.vm', in the 'subject' directory to include the epic name in the subject, see the second code block.  The code displayed here is wrapped but when you place it in the subject template it must all be on a single line immediately following the "#disable_html_escaping()" directive.

I hope this helps.

If you find this helpful accepting this as an answer would be appreciated.



## Add Custom Information to the e-mail notice
    Custom Information:
    Project: $issue.getProject().name
#if ($issue.getSummary()) ##
    Issue Summary: $issue.getSummary()
#if ($issue.getDescription()) ##
    Issue Description : $issue.getDescription()
#set ($issueType = $issue.getIssueTypeObject().name)
#if ($issueType == "Epic")
    #if ($issue.getCustomFieldValue($customFieldManager.getCustomFieldObject("customfield_10011")))
        Customer: $issue.getCustomFieldValue($customFieldManager.getCustomFieldObject("customfield_10011"))
    Linked Issue Info (tasks in epic): ##
    #foreach ($outlink in $outlinks)
    Linked Issue (key-name): $outlink.destinationObject.key - $outlink.destinationObject.summary ##
    #if ($issue.isSubTask())
        #set ($issueParent = $issue.getParentObject())
        Parent issue: $issueParent.getKey() - $issueParent.getSummary()
        #set( $epicCF = $customFieldManager.getCustomFieldObject("customfield_10006") )
        #set( $epicKey = $issueParent.getCustomFieldValue($epicCF))
        #set( $epicDisplayName = $epicCF.getCustomFieldType().getEpicDisplayName($epicKey))
        Issue: $issue.key - $issue.summary
        #set( $epicCF = $customFieldManager.getCustomFieldObject("customfield_10006") )
        #set( $epicKey = $issue.getCustomFieldValue($epicCF))
        #set( $epicDisplayName = $epicCF.getCustomFieldType().getEpicDisplayName($epicKey))
    Issue Epic Key: $epicKey
    Issue Epic Name: $epicDisplayName ##

Subject Line Code:

$issue.getKey(): $issue.getSummary() -#if 
($issue.getIssueTypeObject().name == "Task") #set( $epicCF = 
$customFieldManager.getCustomFieldObject("customfield_10999")) #set( 
$epicKey = $issue.getCustomFieldValue($epicCF)) 
$epicCF.getCustomFieldType().getEpicDisplayName($epicKey) -#end 
#if($issue.isSubTask()) #set ($issueParent = $issue.getParentObject()) 
#set( $epicCF = 
$customFieldManager.getCustomFieldObject("customfield_10999")) #set( 
$epicKey = $issueParent.getCustomFieldValue($epicCF)) 
$epicCF.getCustomFieldType().getEpicDisplayName($epicKey) -#end 
 $i18n.getText("") (JIRA)


Related Questions:

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Jan 08, 2019 in Jira

How to Jira for designers

I’m a designer on the Jira team. For a long time, I’ve fielded questions from other designers about how they should be using Jira Software with their design team. I’ve also heard feedback from other ...

1,154 views 5 10
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you