Documentation for GreenHopper 6.2.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, hover over the epic then click the triangle at the left of the epic name to display the epic details.
  6. Click Create issue in epic at the bottom of the epic details in the Epics panel.

... when viewing the epic in JIRA

  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

... 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. Drag the issue(s) onto the relevant epic. The epic will turn green (see Screenshot 2).
  6. 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

 

... when viewing the issue/story in JIRA

  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. Edit the issue and select the appropriate epic in the Epic Link field.