Enable releases and versions
Releases represent points in time for your project. They can be used to schedule how features are rolled out to your customers, or as a way to organize work that has been completed for the project.
Enable the releases feature
You must have project administrator permissions to enable features.
Next to your service project’s name in the sidebar, select More actions (•••), then Project settings.
Go to Features.
Toggle Releases on.
Another way to enable the releases feature is by:
In your project navigation, select add to navigation (), then select Releases.
Select Add to navigation.
When you enable the releases feature:
A new Fix versions field will be added to your work types.
A new Releases tab will be added to the project navigation.
Create a new version
You must have project administrator permissions to create or edit a version.
From the Releases page
From your project navigation, select the Releases tab.
Select Create version.
When you create a version, you can enter the:
Name: choose a name that’s easily identifiable for your teammates so they can recognize the version.
Start date: the date work on the version will start.
Release date: the planned release date for the version.
Description: more information about what you plan to release in the version.
Driver: someone in your team with project administrator permissions who’s responsible for coordinating the release from start to finish (by default, it’s the person who creates the version).
Assign versions to your work items
From the release page
From your project navigation, select the Releases tab.
Select your version from the list.
At the bottom of the screen, select Add work items.
Search for a work item key or summary.
Choose the work item to add to the version, then select Add.
From the work item
Open a work item.
Under the Fix versions field, select a version to add the work item to. You can select more than one version.
From the Versions panel
On the Backlog, select the Version filter and enable the Versions panel toggle.
Navigate to the Backlog tab in your project navigation.
Open the Versions panel.
Drag a work item to the version you want to add it to.
Here, you can also drag-and-drop work items from one epic to another. Hold Ctrl (Windows) or Command (Mac) to multi-select.
Filter versions on the Board and Backlog
Navigate to your project's Board view or Backlog view.
In the Versions filter or panel, select one or more versions. Work items belonging to these versions will continue showing, while all other issues will be hidden.
Work item created while versions are selected in the Version filter will automatically be added to those versions.
Use JQL to do advanced searching using versions
You can use JQL to perform more powerful searches using versions.
Select Filters in the sidebar, then Search work items.
Select Switch to JQL.
In your JQL query, you can use the FixVersion operator to search for work items in a specific version. e.g. FixVersion = 1.1
Add related work to your version
Related work can include release notes, analytics dashboards, designs, support documentation, business projects calendars, and more. Add items to a version to help team members and stakeholders easily find them.
From your project navigation, select the Releases tab.
Select your version from the list.
In the Related work section, select Add.
Enter the related work’s URL and a description (optional).
You add the URL and description later, if the items aren't ready yet.
Select a Category, then Save.
To Edit or Remove related work, select more actions () to the right of the item.
To assign someone to work on an item, you’ll need to link it to a work item. Hover over the item and select Link work item (existing), or Create work item.
Share release dates with a business team
Keep your business teams in the loop by surfacing your release dates in their calendar.
Read more about showing software release dates in a business calendar
Monitor the progress of your versions
The releases feature shows how much work has been completed in each version. It shows a summary and breakdown of the work items in the version.
If you have connected Jira Software to your development tools, the release page will show development information about pull requests, commits, builds, and deployments associated with your work items.
Depending on which development tools are connected, warnings can also appear when your work item data is potentially out of sync with your development data. These include warnings about issues that are marked as done but have open pull requests or unreviewed code.
Was this helpful?