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) Note that this page only applies if you are using the Classic Boards (which are no longer being actively developed; read more).
If you are using the new boards, please see Creating an Epic instead.

(tick) In GreenHopper version 6.1.3 and later, you can migrate your Classic epics to the new boards. Please see Migrating Epics.

 

If your project administrator has set up epics for your project, you will be able to create epics and link them to child issues, such as stories. You can then view the epic and related issues via the GreenHopper Classic search.

To create an epic,

  1. Login to JIRA.
  2. Select Agile > Classic in the top navigation bar. Then select Classic Planning Board from the drop-down below the project name.
  3. Select your project from the project dropdown in the top left of the Planning Board, if it is not already selected. The Planning Board will refresh with information for your project.
  4. Click the New Card button (at the right of the screen). Create a new card with the appropriate issue type, i.e. 'Epic', if your project administrator has set it up. See Creating an Issue in GreenHopper Classic for details.
  5. Save the new card. If your project is using the 'Scrum' template, the new card's issue key will automatically appear in its 'Epic' field. If not, edit the new card and type its issue key into the 'Epic' field.

To associate an issue with an epic,

  1. Login to JIRA.
  2. Select Agile > Classic in the top navigation bar. Then select Classic Planning Board from the drop-down below the project name.
  3. Select your project from the project dropdown in the top left of the Planning Board, if it is not already selected. The Planning Board will refresh with information for your project.
  4. Locate the card you want to associate with your epic, and click the icon to the right of the 'Epic' field to edit it. (This icon will appear when your mouse pointer hovers over the Epic field).
  5. Enter the issue key for your epic in the 'Epic' field and click the 'tick' icon to save this change. Your issue will be associated with the epic.

To view all issues associated with an epic,

  1. Login to JIRA.
  2. Select Agile > Classic in the top navigation bar. Then select Classic Planning Board from the drop-down below the project name.
  3. Select your project from the project dropdown in the top left of the Planning Board, if it is not already selected. The Planning Board will refresh with information for your project.
  4. You now have two options:
    • On an epic card, click the epic's key at the bottom right of the card to see all the associated cards.
      (info) The words 'Show all linked issues' will appear when you hover over the epic's key.
    • On a non-epic card, click the associated epic key in the 'Epic/Theme' field of the card.
  5. The 'Epic/Theme' popup window will display, showing all cards associated with the epic. The card for the epic and statistics for all issues associated with the epic will be displayed on the right of the popup window.

 

Screenshot 1: Viewing all issues associated with an epic from an epic card

Screenshot 2: Viewing an epic and associated issues on the 'Epic/Theme' popup window