Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Issue Bulk Importing, how do I import the epic Link?

I have a csv file that I am using to bulk import issues. All of the columns/data are translating without issue except for the "Epic Link" Field.

I have an Epic with the Epic Link "Test Epic". I have a column in my csv file called "Epic Link" and the relevant rows have the value "Test Epic".

When I bulk import my issues this value is not populated and it doesn't generate an error. I have tried with and without quotes. Any ideas?



3 answers

1 vote

Are you importing the issues to a Company Managed project or a Team Managed project?

For a Team Managed project it is currently not possible to use the CSV import to link stories to Epics.

For a Company Managed project, if the Epic already exists in Jira and you know its Issue Key (i.e. ABC-123), add that key to a column in your CSV for each child issue, and link that column to the Epic Link field when mapping fields for your import.

If you are trying to create the Epic in the same CSV import process as the child issue, then you have to do something like this:

Type,Issue ID, Summary, Epic Link
Epic, 1, Epic Summary, 
Story, 2, Story 2 Summary, 1
Story, 3, Story 3 Summary, 1
Story, 4, Story 4 summary, 1

Create an Issue ID field in your CSV. Assign unique numbers in that column to each issue. For the child issues, put the Issue ID value of the parent Epic in the Epic Link column for those child issues. When importing the data, again map that Epic Link column to the Epic Link field.


This is for a company managed project. The epic does already exist within Jira.

So in the current epic link column I have, I can just replace the name "Test Epic" name I currently have with the issue key of the epic and that will work?

Yes, it should.

Can confirm, as of 2022-09-13, you still cannot link new issues to Epics when importing issues for a Team-managed project.

You can vote/comment on Atlassian's backlog issue about that here:

0 votes
Mayur Jadhav Community Leader Nov 05, 2021

Hi @John 

I have already provided answer for the similar question, would request you to check this too.!!!

csv import: import to issue under epic

Please let me knw in case of any queries or questions.



Suggest an answer

Log in or Sign up to answer
Site Admin

Atlassian Community Events