About the

Versions Manager

You can create and manage versions from the Team Versions will be manager, accessible from :the project navigation or the apps menu

in the

on Jira’s 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

• …

Version operations

Creating a new version

It’s possible to create a new version from:

• the app page (full-screen and with sidebar alike);

• the issue by clicking the new version button.

The name for the version is mandatory, and the field has focus on when the user opens the modal. The new version will then be available in all projects and will show in the app.

The save button is disabled until the user enters a name. Dates and descriptions are optional.

Release version

Users can release versions at any moment by clicking the “release” button.

If everything is done, the modal displays a confirmation modal to confirm the release date.

If there are unresolved issues, the user must send 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.

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.

  Image Added

• [Optional] Add a start and end date.

• [Optional] Add a description.

• Click the “Save” button.

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.

  Image Added

• Click the “Edit” option.

• Edit the fields as needed.

• Click “Save.”

Release Version

You can release a version anytime by clicking the “Release” button in the versions list.

Image Added

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.

• ”

Previously released versions can be unreleased from the [···] menu. A flag appears to confirm the status change.

Edit version

When the user edits a version, a flag appears to confirm the status change.

Archive / Unarchive version

Toast message to confirm the status change

Delete version

A user can delete version a version from the table.

A confirmation dialog is shown if the version has associated issues. The user can choose to move issues to a different version or just delete the version.

If the version has no issues, it’s deleted directly, and a toast is shown.

Version detail page

When the user clicks the version name, a detail page opens.

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.

~~~~~~~~

Issues section:

The issues section includes a progress bar of the version that reflects the done / in progress / to do issues.

The issues are organized in a table, that can be filtered with the tabs.

Users can add issues to the version, either from the empty view or the add issues button in the issues section. Multiple issues can be added at a time.

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.

Image Added

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.

Image Added

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.”

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.

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.

Image Added

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.

  Image Added

• Select issues from the dropdown menu or search them by key or summary.

• Click the “Add” button.

Moving issues to a different Version

Sometimes priorities change, and you might need to change the version associated with an issue.

Image Added

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.

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.

Image Added

This action only removes the issue from the version. It doesn’t delete the issue.