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

Release Version

You can release a Versions version anytime by clicking the “Release” button in the Versions 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 choose to move them to a different version or ignore them, confirm the release date, and press “Release.”

Archive Version

It’s possible to archive versions you won’t need but want to keep a record. From the Versions versions list, open the context menu and click the “Archive” option.

Image Added

Delete Version

If you no longer need a Version 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 doesn’t have version has no associated issues, you can confirm by pressing “Delete.”

• ⚠️ If the Version version has associated issues, you can choose to move them to a different version or simply remove the Version version information , from the issues and confirm by pressing “Delete.”

Version detail

page

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.

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