How to import parent-child related issues?

On this Page


The 2-layer model (task - subtask)


If you would like to create a parent issue with 2 child items like this:

  • Story 1
    • Sub-task 1.1
    • Sub-task 1.2


It is important to know:

  • when you paste it into the ImpEx import dialog
    • please make sure that you refer to the correct Project name
    • always copy the column names too
  • Sub-tasks are automatically assigned to the Story that are above them


(More about importing in general: Importing)


Please use this template

ProjectSummaryIssue Type
Project 1Task 1Task
Project 1Sub-task 1.1Sub-task
Project 1Sub-task 1.2Sub-task


The 3-layer model (epic - task - subtask)


If you would like to create an epic with two tasks (one with 2 child items) and 2 subtasks like this:

  • Epic 1
    • Story 1.1
    • Story 1.2
      • Sub-task 1.2.1
      • Sub-task 1.2.2


It is important to know:

  • when you paste it into the ImpEx import dialog
    • please make sure that you refer to the correct Project name
    • always copy the column names too
  • Sub-tasks are automatically assigned to the Story that are above them
  • To have the storys assigned to an epic you will have to use the Epic name, the Issue ID and the Linked Issues columns.


(More about importing in general: Importing)


Please use this template

ProjectSummaryIssue TypeEpic NameIssue IDLinked Issues
Project 1Epic 1EpicEpic 11is Epic of: 2 (Epic-Story Link); is Epic of: 3 (Epic-Story Link)

Project 1

Story 1.1Story
2
Project 1Story 1.2Story
3
Project 1Sub-task 1.2.1Sub-task
4
Project 1Sub-task 1.2.2Sub-task
5

The 4-layer model (initative - epic - task - subtask)

If you already have initatives and you would like to create 2 epics in it with two tasks (one with 2 child items) like this:

  • Initiative 1 (Issue Key = TP-1)
  • Initiative 2 (Issue Key = TP-2)
    • Epic 2.1
    • Epic 2.2
      • Story 2.2.1
      • Story 2.2.2
        • Sub-task 2.2.2.1
        • Sub-task 2.2.2.2


It is important to know:

PRO TIPP:

  • You can connect Epics to initiatives with the help of the Parent Link column
  • Parent Link import format: <Issue Key>

(More about importing in general: Importing)


ProjectSummaryIssue TypeEpic nameIssue IDLinked IssuesParent Link

Project 1

Epic 2.1EpicEpic 2.11
TP-2
Project 1Epic 2.2EpicEpic 2.22is Epic of: 3 (Epic-Story Link); is Epic of: 4 (Epic-Story Link)TP-2
Project 1Story 2.2.1Story
3

Project 1Story 2.2.2Story
4

Project 1Sub-task 2.2.2.1Sub-task
5

Project 1Sub-task 2.2.2.2Sub-task
8