---
title: "Flexible Release Notes"
canonical: "https://help.releasemanagement.app/space/RMC/348389377/Flexible%20Release%20Notes"
format: markdown
---
> Macro (include)

# Topics

> Macro (toc)

# Overview

Release management app has embedded functionality for release notes generator. User can define multiple release notes templates for versions and packages and use them for the notes generation.

Release notes templates support rich text formatting. Furthermore, data from version or package (such as version or package props, issues lists and etc.) could be automatically injected into the notes body.  

# Quick start guide

In order to generate your first release notes please follow a few simple steps:

1. Navigate to “Release notes” tab in the board menu
2. Click create template button:
  
3. Specify template name and save a template with a default body:
  
4. Click “Generates Notes“ button
5. Choose version from a list and click “Generates Notes“ button
  
6. Download generated release notes as HTML or upload to confluence

# Release notes templates

## Templates operations

User can create, clone or delete release notes template. 

While creating a new template user have to specify a template type - whether it goes for versions or packaged?

![image](media://faea3a66-2f62-4dda-9078-ef04d5420f58)

> ℹ️ Template type could be defined **only** during release notes template creation and **can not be changed** after that.

## Formatting notes template body and injecting variables

Following features are available for the rich text formatting:

![image](media://89c261e0-e889-4c1b-800b-de5fe89dfa15)

- Define text style
- 3 fonts are supported
- Bold, Underlined, Italic styles
- Define text color and background
- Text alignment
- Insert numeric or bullet lists
- Insert a link
- Pictures
- Code block
- 🆕 **Custom HTML tables**

Also, the user can inject version/package variables into the template body. The variables will be replaced with actual values from the selected version/package during rendering the notes.

The list of available variables depends on selected template type - version or package.

### Version variables

- Name
- Start date
- Release date
- Description
- “Released” or “Unreleased“ - standard Jira version statuses
- Project key (fixVersion only)
- Project name (fixVersion only)
- User name. Name of a user who generated release notes
- Current date. Date when release notes were generated.
- Current timestamp. Date and time of release notes were generated.

### Package variables

- Name
- Start date
- Release date
- Description
- User name. Name of a user who generated release notes
- Current date. Date when release notes were generated.
- Current timestamp. Date and time of release notes were generated.

## JQL Table section

### Summary

Table of listed issues based on JQL query could be added to the release notes body.

Use “+JQL table“ button to add a new table to the template.

![image-20240513-115804.png](media://a866c5c3-b961-4535-95a0-041a3b67da2b)

The following configuration parameters are available for the table:

![image-20240513-115845.png](media://a593f67a-eca8-4a8b-aa54-207a3a03a711)

- **Name of the section**. A section with the same name will be added to the release notes.
- **Columns to be shown in the table**. User can select the majority standard and custom Jira fields. See details in the chapter below.
- **Section description**. If the text is specified - it will be added as a plain text after the section name.
- List of available** JQL variables**. In order to build flexible JQL which will use data from the selected version or package the user can inject variables to JQL query. List of available variables depends on the template type
  - Version specific variables
    - Version name
    - Start date
    - Release date
    - Version JQL (precompiled JQL which can help to extract the content of real or virtual version)
    - Project key (:info: Not applicable for virtual version)
    - User name
    - Current date
    - Current timestamp
  - Package specific variables
    - Start date
    - Release date
    - Version JQL (precompiled JQL which can help to extract the content of package)
      - :warning: Please note that “Versions in package” variable is not supported since October 2020
    - User name
    - Current date
    - Current timestamp
- **JQL query **to extract an issue list.** **
- **Group by**. In the past we allowed grouping issues by Epics only in JQL tables. Now you can do it by most of single-, multi-select fields, epics, components, labels, etc.

![image-20240513-120310.png](media://8da27460-5a85-4190-921a-7588da36dc94)

 **Render section if result is empty**. If the option is enabled the section will be rendered if JQL will return 0 rows. Otherwise, the section will not be rendered at all.

- **Layout** - table or card

> ⚠️ Please note that old variables to extract all version or package content (*fixVersion={**[version.name](http://version.name)**}*,*fixVersion IN ({package.versions})*) do not from October 2020.
> ⚠️ 
> ⚠️ Please use {version.jql} or {package.jql} instead of *fixVersion={**[version.name](http://version.name)**}* or ,*fixVersion IN ({package.versions}) *respectively.
> ⚠️ 
> ⚠️ This is the change we had to do to introduce virtual versions and align between fixVersions and Virtual versions. Thanks for understanding.

### Columns configuration

On the "Columns" tab the user can define a list of columns to be presented the table or meta-data presented on Card layout.

Majority of standard fields and custom fields are available here. 

Also, the user can define various render type where it is applicable. 

![image-20240417-090535.png](media://a48d0a3f-635c-4e74-980e-2ef4580c6831)

User can change columns order.

#### Render types

Available render types are:

- Text - just a plan text
- Link - link to a presented entity. E.g. issue, user, component, label etc.
- Icon - icon for the defined value. For instance issue type icon.
- 🆕 Dynamic Confluence

> 📝 The later is only available for **Key** and **Summary** fields. You want see a major difference when you generate notes, but when uploading to Confluence we will render it as Confluence standard issues status macross representing key, summary and up-to-date status.
> 📝 
> 📝 ![image-20240417-091002.png](media://39c15832-ce15-446f-ac6a-f097cb28cfe4)
> 📝 
> 📝 As a side effect of this render type you will get a mention in your Jira issue about release notes generated in Confluence.
> 📝 
> 📝 ![image-20240417-131436.png](media://f3c003b9-1dca-4e63-befe-087b8583fc3d)

#### Calculated fields

We also provide a couple of additional "CALCULATED" fields to outline

##### Parent Epic

- Parent Epic Name - link to parent epic (if any) with Name to display
- Parent Epic Status - status of the parent epic

![image](media://f2465ebe-d84b-4a02-a136-9c3818f7a6a6)

##### Commits, Pull Requests and Development Field

Information about Commits, Pull Requests and a complete Development Field for the specific issue.

![image-20240226-131357.png](media://10733680-268b-4f1d-a1c8-131ad33b6d62)

### Grouping options

We support a 2-level grouping capabilities for your issues in JQL table. And we support a wide range of Jira standard and custom fields for it.

![image-20241227-140535.png](media://0b0f17bf-c685-4202-8005-81a280e40d03)

If 2nd level is selected you can decide whether to call the group

- Level 1, Level 2a
  - *issues*
- Level 1, Level 2b
  - *issues*

or make **hierarchical structure **of it

- Level 1
  - Level 2a
    - *issues*
  - Level 2b
    - *issues*

You can generate it as single table with grouping headers (rows) or as **separate tables. **If the later, every new group will have a header **“+1**“ to a header style defined for complete JQL table

![image-20241227-141227.png](media://b5da0cad-7dc3-4596-bf67-c4dc55a73a73)

### Cards vs Table Layout

If you need to show too many columns in your Release Notes you can select a horizontal layout to show issues as cards.

![image](media://ae8202b4-e227-4084-af42-d43f09699efc)

## Environments table

Click on “+ Environments table“ to amend you release notes with information about Environments. To outline where your artifacts are deployed and what are build numbers.

![image](media://a10bd053-8898-4df4-ab10-37f01d205c49)

![image](media://0d61b188-a650-469b-89ed-f9e1c13cd241)

To delete it use “Del”, “Backspace“ or right-click and select “Delete”.

## Milestones table

For Versions and Packages you can also add Milestones table to print out details about intermediate milestones achievements:

![image](media://dea972c2-7b68-47ac-a4b7-fdaa4490ec86)

![image](media://b6de77cf-4bc5-47ab-ac7b-b8e9c133ae0d)

For Packages the output will include individual Package milestones as well we aggregated encompassing versions milestones to follow.

## Versions table

For your Package Template you have an option to add Versions table.

![image](media://4f135493-4f05-4231-b179-782fd44f768e)

This will print out all the encompassing versions, Epics, Sprints, JQL versions and their basic details.

![image](media://9479564b-a9b9-4e93-b277-ea8ec94043ba)

## Free text variables

In case you need to populate some text at release notes compilation process you can define “**Free text variables**“

![image-20260223-152533.png](media://4e910eac-d586-44bd-8709-c4eaa8cfa65b)

![image-20260223-152603.png](media://d5639330-b8ba-4ff9-a9bb-ddfc114a1bb0)

The App will prompt the text as you generate notes either manually or as automation configured for one of the transitions.

# Compilation Progress

Once you click **Generate** Notes the App will show you a completion progress counting down on sections remaining.

![image-20240226-131645.png](media://3b1118e0-2467-418a-b92a-966ed19e9cd7)

# Export options

## Download as HTML

The output on Release Notes could be downloaded as HTML

![image-20240131-091621.png](media://c2dbf55b-3ee2-4ad2-a283-b7d7d2ebc70f)

There are 2 options to download, namely:

- All-in-one, so HTML content and images embedded (single .html file)
- or Split Images HTML, when the output is a zip package with HTML and local images. This is recommended solution if you plan to translate images alongside your content or do other required amends to graphics

You can use it to Copy/Paste into MS Word, Google Docs, Confluence and any other wiki with (almost) no changes to layout. See other options below plus Upcoming Features for more formats we plan to support shortly.

## Download as AsciiDoc

AsciiDoc is a lightweight markup language that helps you concentrate on writing content rather than being distracted by complex word processors, bury the content in XML schemas like DocBook, or battle with finicky WYSIWYG editors. [Read more](https://www.writethedocs.org/guide/writing/asciidoc/).

With Flexible Release Notes in Release Management App you can now download your notes in AsciiDoc format.

![image](media://39d99cbe-09c4-4e68-9691-73495d526370)

## Upload to Confluence

> 📝 As of 4/7/2026we delivered a cross-product App thus removing the need to use API tokens for Confluence upload. Same time you have to connect Confluence in Jira Admin to our App so you can use **Upload to Confluence** functionality.
> 📝 
> 📝 [https://releasemanagement.atlassian.net/wiki/spaces/RMC/pages/3934257153](https://releasemanagement.atlassian.net/wiki/spaces/RMC/pages/3934257153)

To substitute “Copy/Paste to Confluence” we implemented a direct integration with Confluence to upload into one of your available spaces.

![image](media://f29bee70-a42b-40eb-9606-ca05b16c48cb)

### Configuring the destination

You will see the following dialog to help us define the destination to upload your release notes

![image](media://c44aa9dd-2af0-4e16-9587-e8fa639a5ed6)

You would need to specify

- Confluence **Space **to shortlist the parent pages
- **Parent page** - any selected page within the Space defined
- **Page title** - you can define a custom name of use some of our release/package variables to include in the naming.

![image](media://9b8c71cc-9e6b-4113-9f69-6465487c4c27)

Click “Export“.

**Navigating to Confluence**

Once our App successfully uploaded your release notes to Confluence, the following confirmation will be shown

![image](media://fcb89e2c-96ab-4510-a2bd-51a05cf9f9b1)

Click on the link specified to navigate to your release notes in Confluence.

![image](media://57800d54-f090-4bb5-9322-d284881a1c77)

### Propagating Confluence link to Epics and Versions

You have an option to automatically add Confluence link with generated notes to all encompassing Epics and Versions. To do so turn on "**Add release notes link to Epics and/or Versions**" toggle before you push to Confluence.

![image](media://2cbdbe91-fbb5-43d3-9017-960ccab7450f)

For Epics Release notes will added as standard links:

![image](media://3d806579-731d-49ad-abe3-1165302c60f0)

For Versions Release notes will added as Related work:

![image](media://120a6b49-3654-45f9-804c-abc190ba603a)

Read more about [Related work](https://releasemanagement.atlassian.net/wiki/spaces/RMC/pages/92111031/Managing+Versions+on+Release+Board#Related-work) functionality in appropriate section of this space.

> 📝 This is applicable for Fix versions only and is not supported for Epics, Sprints or JQL-based versions.

> Macro (include)