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.
Search for issues, navigate to your work, use advanced search, and work with your search results.
Plan and view work across multiple teams, projects, and releases using Plans.
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.
Open the version panel by using the toggle in the version filter dropdown.
Add a new version
In the version panel, select + Create version.
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 an issue to a version
Drag and drop the issue onto the version in the panel.
Remove an issue from a version
Drag and drop the issue onto the Issues without versions section in the panel.
Filter issues by version
Select the relevant version in the panel to show only issues in that version.
To remove the filter, ensure that no version is selected in the panel.
In the version panel, versions with at least 1 issue 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 issues in each status category (To Do, In Progress, Done).
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?