About the Versions Manager
You can create and manage versions from the Team Versions manager, accessible from the project navigation or the apps menu on Jira’s main navigation.
When you open the Team Versions app, you'll see a list of the versions available in your Jira instance. If there aren’t any versions, you can create the first one [link to create version].
Team Versions app home page:
List of versions available in all the projects of your Jira instance.
Search field: filter the versions list to find the right one quickly.
Reload: update the versions list with the latest changes.
Create version
Versions table with name, status, progress, start & end date, description, and actions.
Managing Versions
Create Version
You can easily create a version in the Team Versions manager:
Instructions:
Click the “Create version” button.
Type the name for the version.
[new version modal][Optional] Add a start and end date.
[Optional] Add a description.
Click the “Save” button.
You can also create versions directly in an issue [link to create in an issue].
Edit Version
You can edit the details of any Unreleased and Archived versions at any moment.
Instructions:
In the versions list, find the one you want to edit and click the context menu.
Click the “Edit” option.
Edit the fields as needed.
Click “Save.”
You can also edit the version on the detail page [link to detail page].
Release Version
You can release a version anytime by clicking the “Release” button in the versions list.
A confirmation dialog opens:
✅ If all issues are done, you can confirm the release date and press “Release.”
⚠️ If there are unresolved issues, you can move them to a different version or ignore them, confirm the release date, and press “Release.”
You can also release the version on the detail page [link to detail page].
Unrelease Version
If needed, you can revert a release. On the versions list, open the context menu and click the “Unrelease” option.
Archive Version
It’s possible to archive versions you won’t need but want to keep a record. From the versions list, open the context menu and click the “Archive” option.
Unarchive Version
Plans might change, and you can unarchive a version by opening the context menu and clicking the “Unarchive” option.
Delete Version
If you no longer need a version, you can delete it. From the versions list, open the context menu and click the “Delete” option.
A confirmation dialog opens:
✅ If the version has no associated issues, you can confirm by pressing “Delete.”
⚠️ If the version has associated issues, you can move them to a different version or remove the version information from the issues and confirm by pressing “Delete.”
This action is undoable.
Version detail page
On the detail page, you can view all the information related to the version.
Editing the Version
The name, dates, and description fields are editable inline. If the user enters a version name already in use, the name doesn’t update, and a flag appears.
Managing issues
Adding issues
You can add multiple issues at once.