Fix Orphan Sub-Tasks in Jira Cloud
Platform Notice: Cloud Only - This article only applies to Atlassian products on the cloud platform.
Summary
Jira's External System Import tool allows the creation of subtasks without a parent issue. However, after creation, you can't manually link orphan sub-tasks to their parent issues using the Jira UI.
Diagnosis
To quickly identify orphan sub-tasks, use the following JQL query:
1
type = Sub-task AND parent is EMPTY
If you try to use the Convert to issue option in an orphan subtask, an error message will appear saying that the issue is not a subtask.
Cause
This happens when sub-tasks are imported to Jira via CSV and the references to parent issues are not present in the file.
Solution
To resolve this issue, you can import a new CSV file to establish the link between orphan sub-tasks and their parent issues.
Example:
To achieve that, you must Import data from a CSV file, using the following file structure:
1
2
3
4
5
IssueKey,IssueType,Summary,IssueId,ParentId
ITMS-48,,,1,
ITSM-49,,,2,
ITSM-47,,,,1
ITSM-46,,,,2
In this example, issues ITSM-48 and ITSM-49 are existing parent issues to which we are assigning the IDs 1 and 2, respectively. ITSM-47 is an orphan sub-task that will become a child of ITSM-48, and ITSM-46 will become a child of ITSM-49.
You can add multiple parents and sub-tasks to the file to fix multiple orphans at a time.
ℹ️ Note: All CSV and Jira fields must be correctly mapped (check the boxes for 'Map field value') for this solution to work.
Once the import is complete, both issues should be correctly associated.
Was this helpful?