Jira is getting a fresh new look and navigation

We’re in the process of rolling out these changes and the documentation may not match your experience. Bear with us while we update it to reflect the new changes. More about navigating the new Jira

Configure versions in a scrum project

A version is a set of features and fixes released together as a single update to your application. Assigning work items to versions helps you plan the order in which new features (stories) for your application will be released to your customers. 

In Jira, you can view your work items according to which version they belong to. You can also drag-and-drop work items into a version to assign them to it, which you should do before you start work on the work items. This helps you plan your upcoming versions, which may span multiple sprints.

Before you begin

  • This page does not apply to Kanban projects. See Configuring versions in a Kanban project instead.

  • The functions for managing versions require different permissions. For example, you need the 'Edit work items' permission to add a work item to a version. Read Permissions overview for more information.

Manage versions

  1. Go to the Backlog of your Scrum project.

  2. Open the version panel by using the toggle in the version filter dropdown.

Task

Instructions

Add a new version

In the version panel, select + Create version.

 

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 details

To expand a version’s details, select the chevron () next to a version’s name.

Select View details to view the version in the Release Hub, where you can update the version’s details.

Add a work item to a version

Drag and drop the work item onto the version in the panel.

Remove a work item from a version

Drag and drop the work item onto the Work items without versions section in the panel.

Filter work items by version

Select the relevant version in the panel to show only work items in that version.

To remove the filter, ensure that no version is selected in the panel.

Tips

  • In the version panel, versions with at least 1 work item will have a progress bar to indicate how your team is progressing with the work added to that version. The bar shows the number of work items in each status category (To Do, In Progress, Done).

  • You can use the JQL fixVersion  field to search for a version's work items. See What is advanced searching in Jira Cloud? for details.

Need help? If you can't find the answer you need in our documentation, we have other resources available to help you. See Getting help.

Still need help?

The Atlassian Community is here for you.