Learn how to set up Jira Software Cloud and integrate it with other products and applications.
Learn how to configure your existing Jira Software Cloud site 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 next-gen projects.
Create powerful rules to start automating your manual, repetitive processes.
Configure versions in a kanban project
Are you on the right help page?
The following information only applies to classic projects.
To check which project you need help with, look at the bottom of your project’s left-hand sidebar:
If you see an icon stating You’re in a next-gen project with Give feedback and Learn more menu items, you're in a next-gen project. Check out our next-gen project documentation.
If you don’t, you're in a classic project.
A version is a set of features and fixes released together as a single update to your product. By default, Kanban boards do not require issues to be pre-assigned to versions. This is because Kanban is designed for a continuous flow of work, rather than set iterations.
On a Kanban board, you can choose to release a version at any point in time — the version will contain all issues that are complete at that time. You also specify the name of a new version at the time of the release.
For information on how to release a version on a Kanban board, see Deploying a release.
Managing versions with the Kanban backlog
If your team is using the Kanban backlog for your Kanban project, you can use the Versions panel to manage versions.
You can only use the Kanban backlog if it's already enabled by a Jira administrator or a board administrator.
The Kanban backlog must be enabled for a particular board, for the board users to use it. See Enabling the Kanban Backlog for more information.
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.
Click Jira home > Projects > Select the relevant project.
Click VERSIONS on the left side of the project's 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.
The Release Date is used to calculate the days remaining in a release on the Release Hub.
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 Backlog or Selected for Development.
Viewing versions in the Kanban backlog
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?