Learn how to set up Jira Software Cloud and integrate it with other products and applications.
Learn how to configure your Jira Software Cloud company-managed projects to suit your agile development processes.
Learn how to create, search, and work with issues in software projects, manage your profile, and more.
Learn how to get started, enable features, and manage and administer team-managed projects.
Plan and view work across multiple teams, projects, and releases with Advanced Roadmaps.
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.
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 Issues' permission to add an issue to a version. Read Permissions overview for more information.
Go to the Backlog of your Scrum project.
Click VERSIONS on the left side of the board (aligned vertically) to open it.
Add a new version
Click Create version (you will need to hover over the 'VERSIONS' panel to show this link), enter the version details, and create it.
Update a version's details
For 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 version
Drag and drop the issue onto the version in the 'VERSIONS' panel.
Remove an issue from a version
Drag and drop the issue onto Issues without versions in the 'VERSIONS' panel.
Filter issues by version
Click 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.
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 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.
Was this helpful?