Documentation for GreenHopper 6.1.x. Documentation for other versions of JIRA Agile is available too.
GreenHopper is now called JIRA Agile. Learn more.

JIRA workflow statuses map to columns on a board.

(info) To configure these mappings, see Configuring Columns.

To transition an issue to a different JIRA workflow status on a board:

  1. Click the Agile link's down-arrow in the top navigation bar, then select your preferred board from the resulting dropdown menu.
  2. In 'Work' mode, transition an issue (or issues) by dragging and dropping the issue from one column to another (see  Screenshot 1 below).
    • Use <Ctrl> or <Shift> to select multiple issues.
      (info) It is currently not possible to transition multiple issues by dragging them to another column. It is possible to move multiple issues within the same column.

    • When you start dragging an issue, you can only transition the issue to columns whose background turns blue. When the issue is hovered over the target column, the blue background turns green.
    • If the target column is associated with more than one status then, when the issue is hovered over that column, each status will appear as a separate section with a dashed outline (see Screenshot 2 below). Complete the transition to the appropriate status by dropping the issue onto the section of the column.
  3. If a dialog box opens for your workflow transition status, you must complete all mandatory fields (indicated by a red asterisk) before submitting the form.

(tick) You can also transition an issue via Keyboard Shortcuts if you prefer.

(info) Please note:

  • To map JIRA workflow statuses to columns in a board, see Configuring Columns.
  • You can only transition an issue if you have permission to move that issue to the status in the JIRA workflow to which the column is mapped.
  • GreenHopper will respect your JIRA worklow configuration and will trigger all your JIRA workflow validations, conditions, functions and notifications on the transitions. (See Configuring Workflow.)
  • Unlike the Task Board, the board currently does not auto-assign issues to you.
  • Once all the sub-tasks of an issue have been completed, it's time to resolve the issue itself. So when you move the last sub-task to the 'Done' column, GreenHopper will prompt you to move the parent issue too. If you resolved the sub-tasks in native JIRA instead, a button will be displayed on the parent issue the next time you visit Work mode.

Screenshot 1: Dragging and Dropping an Issue to Another Column

Screenshot 2: Dragging and Dropping an Issue to a Column with Multiple Statuses