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, the first thing you'll see is a list of the versions available in your Jira instance. If there aren’t any versions yet, you can create the first one [link to create version].

Managing

Versions

Create Version

You can easily create a Version version in the Team Versions manager:

:

• Click the “Create version” button.

• Type the name for the Versionversion.[new version modal]

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

Info
You can also edit the version on the detail page.

---

Release Version

Users You can release versions at any moment a version anytime by clicking the “release” “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.

When the user releases a version, a flag confirms the status change.

Unrelease Version

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

Archive Version

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 vision

Versions have a detail view.

• view issues attached to the version

• add issues

• move issues to a different version

• release

• …

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.

• ”

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.