Migrating Epics

If you were previously using epics on the Classic boards, you can easily migrate your epics to your new boards (in GreenHopper 6.1.3 and later versions).

To migrate your old Epics:

1. Log in as a user with the 'JIRA Administrators' global permission.
2. Select JIRA Administration from the top bar, then select Add-ons > GreenHopper.
   OR, if you are using JIRA 6.0 or later, click the 'cog' icon in the top bar, select Add-ons, then scroll down the page to the GreenHopper section.
3. Select Classic Migration, then click Start Classic Epic Migration.
4. Select the project(s) whose epics you wish to migrate, then click Next.
5. In the Summary popup, verify that the number of epics is what you expect, then click Migrate.

Screenshot - successful Epic Migration

Please note that this migration allows you to move your existing epics so that you can start managing them on the new boards. If you later create more epics on the old Classic boards, those epics will not be automatically migrated, but you can migrate them at a future date by re-using the process above.

Technical note: the migration process will find issues with an issue key in the 'Epic / Theme' field and convert it to an 'Epic Link' field (unless the issue already has an Epic Link field). For more details about these fields, please see GreenHopper JIRA Configuration