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

(info) Please note:

  • This page only applies to Scrum boards.

  • You will need to have the 'Edit Issue' permission in the project(s) to which the issue belongs and to which the Epic belongs. 

Creating a new issue in an epic

... in Plan mode

  1. Log in to JIRA.
  2. Click the Agile link's down-arrow in the top navigation bar, then select your preferred board from the resulting dropdown menu.

  3. Your board will be displayed. Click Plan.
  4. If the Epics panel is not shown at the left of the screen, select Tools > Show Epic Panel.
  5. In the Epics panel, click the triangle at the left of the epic name to display the epic details.
  6. Click the Create Issue in Epic link in the relevant epic box in the Epics panel.

... when viewing the epic in JIRA

In GreenHopper version 6.1.2 and later:

  1. Click the Agile link's down-arrow in the top navigation bar, then select your preferred board from the resulting dropdown menu.
  2. Click the issue key (or type t) to display the Issue Detail View.
  3. In the Issue Detail View, click the issue key, or type 'o', to view the epic in JIRA.
  4. Click the "+" at the end of the Issues in Epic heading (see Screenshot 1).

Screenshot 1: viewing an epic in JIRA

Adding existing issues to an epic

  1. Log in to JIRA.
  2. Click the Agile link's down-arrow in the top navigation bar, then select your preferred board from the resulting dropdown menu.

  3. Your board will be displayed. Click Plan.
  4. If the Epics panel is not shown at the left of the screen, select Tools > Show Epic Panel.
  5. In the Epics panel, click the triangle at the left of the epic name to display the epic details.
  6. Drag the issue(s) onto the relevant epic. The epic will turn green (see Screenshot 2).
  7. The epic's name will be displayed on the issue as a coloured lozenge.

Screenshot 2: adding an issue to an epic in Plan mode