Migrating Epics

If you were previously using epics on the Classic boards, you can easily migrate your epics to your new boards.

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 > JIRA Agile.
   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 JIRA Agile 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 epic links so that you can start managing epics and their issues on the new boards. Epic links created on Classic boards after the migration can be migrated at a later stage.

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