Note that this page only applies if you are using the
Classic Boards (which are no longer being actively developed;
read more).
Instead, please see
Releasing a Version (Kanban).
GreenHopper enables you to create and release a new JIRA version from the far-right column (usually named 'Done') on the Task Board, in a single step.
This is useful for creating an ad-hoc release whenever your 'Done' column contains enough value to warrant it, whereas the procedure for Adding a Version typically applies to a release that has been scheduled in advance.
For a version that has been scheduled in advance, you will need to release the version from the Planning Board.
Creating and Releasing a Version from the Task Board
To create and release a new Version from the Task Board,
- Log into JIRA.
You will need to have the JIRA 'Project Administrator' permission in the project whose issues are to be included in the version. Select Agile > Classic in the top navigation bar. Then select Classic Task Board from the drop-down below the project name.
- Select your project from the project dropdown in the top left of the planning board (above the 'Task Board' dropdown), if it is not already selected. The 'Task Board' will refresh with information for your project.
- From the 'Views' menu, select 'Compact (Kanban)'.
- In the 'Done' column, click the icon (which will appear at the top right of the column when you hover over it).
- Select 'Release' from the drop-down menu. The 'Release Done from <Version>' window will display (see Screenshot 1below). Complete the fields as follows:
- 'Version name' — Enter a short name for your new version. For details, see the JIRA documentation on Managing Versions.
- 'Start date' (optional) — Enter the start date for your new version. This will default to the date of the first transition of a card presently in the 'Done' column.
- 'End date' (optional) — Enter the end date for your new version. This will default to today's date.
- 'Release date' (optional) — Enter the date of release for your new version. This will default to today's date.
- 'Description' (optional) — Enter a longer description for your new version. For details, see the JIRA documentation on Managing Versions.
- Click the 'Release' button to save your new version and mark it as 'released' throughout JIRA and GreenHopper.
Screenshot 1: Releasing a version from the Task Board
If the 'Done' column on your Task Board is mapped to both the 'Closed' and 'Resolved' statuses, please note that any issues that are 'Closed' can no longer be edited (and will already have had their Fix Version set).
Releasing a Version from the Planning Board
To release a pre-existing Version from the Planning Board,
- Login to JIRA.
You will need to have the JIRA 'Project Administrator' permission in the project whose issues are to be included in the version. Select Agile > Classic in the top navigation bar. Then select Classic Planning Board from the drop-down below the project name.
- Select your project from the project dropdown in the top left of the planning board (above the 'Planning Board' dropdown), if it is not already selected. The 'Planning Board' will refresh with information for your project.
- Select 'Version' mode (see Using Classic Planning Board Modes).
- In the 'Statistics' column at the right of the screen, click the box representing the version you wish to release. Then click the icon (which will appear at the top right of the selected box when you hover over it) to display a drop-down menu. Select 'Release'. A snapshot of all of the charts associated with this version will also be captured (before any issues are swapped). You will be able to access these snapshots via your Released Board.
- If the version contains unfinished issues, you will be prompted to either ignore them and proceed with the release, or move the unfinished issues to another version of your choice.