Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
nameintro

On this page, you'll find everything about using the Team Versions app. From creating versions to shipping releases.

Table of Contents
minLevel1
maxLevel2


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

 

Team Versions app home screen:

List of versions available in all the projects of your Jira instance.

  1. Search field: filter the Versions list to quickly find the right one.

  2. Reload: update the versions list with the latest changes.

  3. Create version

  4. Detailed list of Versions: status, progress, start & end date, description, and actions.


Managing versions

Create Version

You can easily create a Version in the 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.

Info

You can also create Versions directly in an issue [link to create in an issue].


Edit Version

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


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 them to a different version or ignore them.

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.

 

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.