Add a new custom style for Jira release notes


I would like to know if it is possible to add new release note template/style for Jira 5.2.

Based on this link:, it is possible to customize the template but what we want is to add a new template so that there will be 3 Release notes style options: HTML, Text and 'Custom Style'

2 answers

1 accepted

This widget could not be displayed.


This is possible!

Just do the following:

  1. Create your new velocity template for your "Custom Format" according to the instructions in the link you found. Name it: releasenotes-custom.vm
  2. Shutdown JIRA
  3. Update the file <JIRA-HOMEDIR> (if this file does not exist, create it!) The JIRA-HOMEDIR is the directory where your attachments and stuff is stored, usually in /.../application-data/jira
    Add the following rows to the file:
  4. jira.releasenotes.templatenames = Text, Html, Custom
    jira.releasenotes.templates = releasenotes-text.vm, releasenotes-html.vm, releasenotes-custom.vm,
    jira.releasenotes.default = Custom
  5. Copy your custom velocity template to <JIRA-INSTALLDIR>/atlassian-jira/WEB-INF/classes/templates/jira/project/releasenotes
  6. Start JIRA

Now you should have three options when generating Release Notes.

Hope that helps!

Kind regards,

// Svante

This widget could not be displayed.

Hi Erwin,

In case you are looking for an easier option, check out the plugin Intelligent Reports. It lets you design your relase notes template in Microsoft Word, and select which issues to include, JQL queries, custom fields etc by a powerful point and click interface. One of the example templates it comes with is Release Notes, so you can use that as a starting point.

Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Posted Wednesday in New to Jira

Are you planning to trial, or are currently trialling Jira Software? - We want to talk to you!

Hello! I'm Rayen, a product manager at Atlassian. My team and I are working hard to improve the trial experience for Jira Software Cloud. We are interested in   talking to 20 people planning t...

131 views 2 0
Join discussion

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