...
...
...
...
Team Versions will be accessible from:
the apps menu in the main navigation;
from the project sidebar;
Populated table
With builds available, the list is populated in a table with the following:
Version
Status
Progress
Start date
End date
Description
Actions (Release, more options: Edit, Unrelease, Archive / Unarchive, Delete)
It’s possible to type on the search field to filter the versions and click the “All statuses” dropdown to filter the specific status of releases.
What can be done with versions
Users can perform various operations:
create / edit / archive / unarchive / release / unrelease / delete
Create Version
The user can create new versions, as seen previously, from the empty screen and then from a button on the top right side of the app.
Release Version
Archive Version
Delete Version
Version detail vision
Versions have a detail view.
...
view issues attached to the version
...
add issues
...
move issues to a different version
...
release
...
| Excerpt | ||
|---|---|---|
| ||
You'll find everything about using the Team Versions app on this page. From creating versions to shipping releases. |
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.
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:
Click the “Create version” button.
Type the name for the version.
[Optional] Add a start and end date.
[Optional] Add a description.
Click the “Save” button.
| Info |
|---|
You can also create versions directly in an issue. |
Edit Version
You can edit the details of any Unreleased and Archived versions at any moment:
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.”
| Info |
|---|
You can also edit the version on the 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.”
| Info |
|---|
You can also release the version on the 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.
| Info |
|---|
You can also archive the version on the detail page. |
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.”
| Info |
|---|
You can also delete the version on the detail page. |
| Note |
|---|
This action is undoable. |
Version detail page
In the Team Versions manager, you can click the version name to open its page, where you can view all the information related to it.
Version detail page:
Version information and list of issues associated with it.
Version name
Start and release date
Description
Version actions
Progress bar
Reload: update the issues list with the latest changes
Add issues
Issues table with issue key, summary, assignee, status, and actions.
Managing the Version
On this page, you can update the details of unreleased versions, including the name, dates, and description fields, by clicking the fields and editing them inline.
You can also perform all the actions related to the version:
Release: click the “Release” button and confirm the release date.
Archive: open the context menu and click the “Archive” option.
Delete: open the context menu and click the “Delete” option.
Managing issues
If you need to update your version’s summary, assignee, or status of the issues, click the issue key to open its detail page and make the necessary changes.
Adding issues
You add issues to your version by:
Clicking the “Add issues” button.
Select issues from the dropdown menu or search them by key or summary.
Click the “Add” button.
| Info |
|---|
You can add multiple issues at once. |
Moving issues to a different Version
Sometimes priorities change, and you might need to change the version associated with an issue.
You can do this from the issues table by clicking the context menu and selecting one of the recent versions or clicking the “View all versions” to select a different one.
| Info |
|---|
You can also edit the version directly on the issue page. |
Removing issues from the Version
You can remove an issue from a version by clicking the context menu and selecting the “Remove from version” option.
This action only removes the issue from the version. It doesn’t delete the issue.
| Info |
|---|
You can also remove the version directly on the issue page. |