Creating release notes

Managing versions

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Jira provides the functionality to create release notes for a specific version of a project. The release notes contain all issues within the specified project that are marked with a specific "Fix for" version.

The release notes can also be generated in different formats - plain text or HTML - so they can be included in various documents.

Example of release notes created in a plain text format:

By default, Jira provides two customized Velocity templates for release notes: an HTML template and a Text one. You can also create your own templates and add them to the system. See Creating a custom release notes template containing release comments for details.

These templates are located under <jira-application-dir>/WEB-INF/classes/templates/jira/project/releasenotes:

  • releasenotes-text.vm

  • releasenotes-html.vm

You can view and create release notes only in projects that have enabled release versions. If you don’t have any versions created for your project, you won’t be able to configure and generate release notes.

Generating release notes

  1. In the top navigation bar, navigate to Projects > View all projects, and find your project.

  2. In the project sidebar, select Releases. 

    tip/resting Created with Sketch.

    If you're using Jira Core, go to Project settings and select Versions.

  3. Open the version you want to generate release notes for.

  4. Select Release notes.

  5. Select the Configure Release Notes link to customize the release notes:

    • Please select version: select the required project version for which the release notes will be generated.

    • Please select style: select the required format of the release notes or use one of the available plain text format templates.

  6. Select Create to generate the release notes using the specified template in the specified format. The release notes will be displayed on the screen and can be copied and pasted to any other application.

 Adding a new format template

  1. Create a Velocity template similar in content to that of the examples provided — releasenotes-text.vm and releasenotes-html.vm. Consult the Jira API documentation and the Apache Velocity user guide.
  2. The title in the template should be modified along with the code within the text area. You don't need to change any other sections of the template.
  3. Add the new format template to the list of existing ones within the file. For each new template format, corresponding entries must be added to the existing values of the following properties:
    • jira.releasenotes.templatenames
    • jira.releasenotes.templates

      Note that:

      • Corresponding entries in both of these properties must be in the same order.
      • If these properties do not exist in your file, then:
        1. For each of these properties, add the property's name
        2. followed by an '='
        3. followed by the content of the property's corresponding <default-value/> element copied from your Jira installation's jpm.xml file
        4. Next, begin adding the corresponding entries for the new format template

      See Making changes to the file for more information.

  4. The new format template is available for selection as a release note format template. For more information, check out Creating a custom release notes template containing release comments.

Last modified on Sep 23, 2022

Was this helpful?

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