Configuring versions in a Scrum project

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

A version is a set of features and fixes released together as a single update to your application. Assigning issues to versions helps you plan the order in which new features (stories) for your application will be released to your customers. In Jira Software, you can view your issues according to which version they belong to. You can also drag-and-drop issues into a version to assign them to it, which you should do before you start work on the issues. This helps you plan your upcoming versions, which may span multiple sprints.

On this page:

Before you begin

Managing versions

  1. Navigate to your board.
  2. Click Backlog. If the Versions panel is not showing, click VERSIONS on the left side of the board (aligned vertically) to open it.

    Add a new versionClick Create version (you will need to hover over the 'VERSIONS' panel to show this link), enter the version details, and create it.
    * The Start Date is used to give you a more accurate Version Report in cases where you might plan a version many weeks or even months in advance, but not actually commence work until closer to the release date.
    * The End Date is used to calculate the days remaining in a release on the Release Hub.
    Update a version's detailsFor the version name, click the arrow next to the name, then choose Edit name.
    For other fields (e.g. Description), click the field to edit it.
    Add an issue to a versionDrag and drop the issue onto the version in the 'VERSIONS' panel.
    Remove an issue from a versionDrag and drop the issue onto Issues without versions in the 'VERSIONS' panel.
    Filter issues by versionClick the version in the 'VERSIONS' panel to show only issues in that version. Click All issues to remove the filter. Alternatively, click Clear all filters next to the sprint's name.

Screenshot: viewing versions in the Backlog


  • The blue horizontal bar under the version's name (in the 'VERSIONS' panel) indicates progress towards completing the work estimated for the version. Note that this bar only represents progress on the estimated issues in a version.
  • You can use the JQL fixVersion  field to search for a version's issues — see JQL (Jira Admin documentation) for details.

Next steps

Need help? If you can't find the answer you're looking for in our documentation, we have other resources available to help you. Check out Getting help

Read the following related topics:

Last modified on Jul 1, 2021

Was this helpful?

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