Managing versions
Versions are points-in-time for a project. They help you schedule and organize your releases. Once a version is created and issues are assigned to it, you can use the version to filter information in various reports. If you've integrated Jira with Bamboo, you can start a build automatically.
For all of the following procedures, you must be logged in to Jira as a project administrator.
Managing a project's versions
You can manage versions in your project's settings:
- Go to your project and click Project settings.
- Choose Versions from the project settings sidebar.
The Versions or Releases page is displayed, showing a list of versions and each version's status. From here you can manage the project's versions as described on this page.
Version status
Each version can have any of the following the statuses:
- Released — a bundled package
- Unreleased — an open package
- Archived — a historical snapshot of a package
Versions that include end dates can indicate when a release is overdue. The release date appears in red for unreleased versions that have passed their planned release date.
The status affects where the version appears in drop-down lists for version-related issue fields, for example Fix version.
How to add a new version
You can create as many versions as you want to represent a package you intend to release.
To create a version:
- On the Releases or Versions screen, select Create version.
- Give the version a name. You might organize versions by number, for example "3" or "3.2.2". Or you might use code names, for example "Corvette" or "DeLorean".
- Optionally, add a start and release date, and a description.
- Select Save.
You can rearrange versions by dragging and dropping them in the table.
How to add a start date
If specified, the Start date is used by the Version Report. This gives you a more accurate 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.
How to release a version
Marking a version as released will affect some changes in some reports and some issue fields' drop-downs. If you have integrated Jira with Bamboo, you can trigger a Bamboo build to run automatically when releasing a version in Jira. The version will only be released if the build is successful. For more information, see Running a Bamboo build when releasing a version.
- On the Releases or Versions screen, find the version you want to release.
- Select the actions menu (
) > Release.
To revert the release of a version, simply select Unrelease from the actions menu ().
How to archive a version
To archive a version (and hide it from reports or other parts of your project):
- On the Releases or Versions screen, find the version you want to archive.
- Select the actions menu () > Archive.
To revert the release of a version, simply select Unarchive from the actions menu ().
How to merge versions
You can merge one version into another and move its issues to the desired version.
To merge versions:
- On the Releases or Versions screen, find the version you want to merge into another.
- Select the actions menu () > Merge.
- In the dropdown, select the version you want to merge to.
- Click the Merge button.
How to edit a version's details
- On the Releases or Versions screen, find the version you want to edit.
- Select the actions menu () > Edit.
- Edit the version's name, start and release date, and description.
- Click the Save button to save your changes.
How to delete a version
- On the Releases or Versions screen, find the version you want to edit.
- Select the actions menu () > Delete.
From here, you can specify the actions to be taken for issues associated with the version. You can either move these issues to another version, or simply remove references to the version you want to delete.
How to reschedule a version
Rescheduling a version changes its place in the order of versions. On the Releases or Versions screen, drag and drop versions into the release order you prefer.