Configure versions in a kanban project

This page applies to company-managed projects only.

Learn more about the difference between company-managed and team-managed projects.

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 Release a version.

Manage versions with the Kanban backlog

If your team is using the Kanban backlog for your Kanban project, you can use the version 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.

  1. Go to the Backlog of your Kanban 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 Release 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 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.

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.

Still need help?

The Atlassian Community is here for you.