How to import issue links from a CSV file in Jiras - Jira Cloud

[Steindl, Calman]

This knowledge base article describes how to import issue links when creating new issues from a CSV (e.g. task x blocks task y).

https://confluence.atlassian.com/jirakb/how-to-import-issue-links-from-a-csv-file-in-jira-740262715.html

This is exactly what i want to do; however, in JIRA cloud the option to map the field "Links (Blocks)" is not available in the options to select.

Is there a different approach that needs to be taken in jira cloud?

[Jeff Abbott]

I am using Jira DataCenter and the issue link import gives no errors and simply fails to import the links:

Here is the detail log (end) file.

2025-10-28T13:04:22,290 INFO - ------------------------------
2025-10-28T13:04:22,290 INFO - Importing: Issue Links & Subtasks
2025-10-28T13:04:22,290 INFO - ------------------------------
2025-10-28T13:04:22,290 INFO - Only new items will be imported
2025-10-28T13:04:22,307 INFO - ------------------------------
2025-10-28T13:04:22,307 INFO - Finished Importing : Issue Links & Subtasks
2025-10-28T13:04:22,307 INFO - ------------------------------
2025-10-28T13:04:22,308 INFO - No issues need to be reindexed

 
CSV File I am importing:

Issue key

Issue id

Summary

Blocks

Parent-Child

Cloners

Dependency

Derives

Duplicate

Follows

Implements

Issue split

Reference

Relates

SDO-1422

Issue Link Test 1

SDO-1423

SDO-1423

SDO-1423

SDO-1423

SDO-1423

SDO-1423

SDO-1423

SDO-1423

SDO-1423

SDO-1423

SDO-1423

My configuration file:
{
"config.version" : "2.0",
"config.project.from.csv" : "false",
"config.encoding" : "UTF-8",
"config.email.suffix" : "@",
"config.field.mappings" : {
"Follows" : {
"link.type" : "10205"
},
"Cloners" : {
"link.type" : "10001"
},
"Relates" : {
"link.type" : "10003"
},
"Blocks" : {
"link.type" : "10000"
},
"Issue key" : {
"jira.field" : "issuekey"
},
"Issue split" : {
"link.type" : "10207"
},
"Reference" : {
"link.type" : "10208"
},
"Parent-Child" : {
"link.type" : "10202"
},
"Dependency" : {
"link.type" : "10203"
},
"Implements" : {
"link.type" : "10206"
},
"Derives" : {
"link.type" : "10204"
},
"Summary" : {
"jira.field" : "summary"
},
"Duplicate" : {
"link.type" : "10002"
}
},
"config.value.mappings" : { },
"config.delimiter" : ",",
"config.project" : {
"project.type" : null,
"project.key" : "SDO",
"project.description" : null,
"project.url" : null,
"project.name" : "Sec Dev Ops Jira Migration",
"project.lead" : null
},
"config.date.format" : "dd/MMM/yy h:mm a",
"config.create.and.assign.default.project.role" : "false"
}

[Steindl, Calman]

Hi, I am the project owern but not the JIRA Admin.

I am doing a All Issues Filter, accessing the hamburger options and then selecting Import from CSV.

Is there any option to allow this import field in a non-admin view.

What a bizarre distinction for the JIRA dev team to have made.

[Trudy Claspill]

Hello @Steindl, Calman 

Welcome to the Atlassian community.

Are you a Jira Administrator or a non-admin user?

How are you navigating to the CSV import functionality? Are you accessing it from the Advanced Issue Search screen, from the Create Issue screen, or from the System > External System Import screen?

As a Jira Admin I am able to see the "Links" option for field mapping from all those locations. It may be the case that the option is available only when a Jira Admin does the import.

[Trudy Claspill]

No, there is no option to make fields available in Import to non-admins when some of those fields are restricted to imports by admins only.

I have not found any documentation that explicitly lists the fields that are limited to only admins.

You'll need to work with a Jira Admin to get your CSV imported if you want it to set the Linked Issues, or else set those links manually after the import completes.