When opening the Epic Clone dialog you can adjust the cloning settings for the parent issue (the one from which you accessed the dialog) on the first screen.
Target project selection:
By default, cloning is done within the same project. However, you can also clone across projects with Epic Clone. Select the checkbox to search for a new target project if you want to clone into a different project.
Dialog if target project is a team-managed project:
Target project selection: Select the target project for your clone. You will only see projects in the select list you have access to.
If you change the target project, it is immediately validated whether the issue type of the source issue is available in the selected target project and whether you have create issue permission in that project. If one of that is not the case, an error message appears.
Dialog if target project is a company-managed project (Epic):
Summary: Set the summary for the cloned issue. The summary of the source issue is displayed by default.
Epic Name: Epics in company-managed projects have the epic name field. If you clone an epic from a company-managed project, you can set the epic name field for the cloned epic. The epic name of the source epic is displayed by default in this case.
Find in description: You can search for text in the description field of the issue and replace it for the cloned issue with another text. This is useful especially when you work with placeholders in description of template issues. You can easily replace them with the actual text during cloning.
Replace with: Text you want as replacement if find text is found in description. Leave this field blank if you want to remove the find text from the description. If find in description field is empty or when the find text is not found, nothing happens to the description of the cloned issue. Its value will be cloned like all other fields.
Clone Attachments NEW : If the source issue has attachment(s) and if you have create attachment permission in the target project, you can decide if you want to clone the attachments or not. By default, it is selected to clone attachments. If the field doesn’t appear, it either means that the source issue doesn’t have attachments, or that you don’t have the permission to add attachments in the target project.
Parent Link Options: If the source issue you want to clone has a parent link set, you can choose whether you want to clone that parent link to the new issue or not. This field only appears when a parent link exists.
Labels: Existing labels of the source issue will be displayed by default. You can select additional labels from the existing ones or add additional new custom labels. The labels inserted in the field will be added to all created issues.
Components: In company-managed projects components can be defined and selected in the issues. If you clone to a company-managed project, you can select components to be set from the existing components in the target projects. This selection list will be populated every time you select a new target project. If you select a team-managed project as target project, the field disappears as components aren’t available in team-managed projects.
Assignee Options: Choose from the following options for the assignee field:
Clone Assignees: Assignees from source issues will be copied to cloned issues. Please note that this is only possible when cloning within same project. If you clone to a different project the issue will be unassigned.
Assign parent issue to me: Cloned parent issue will be assigned to user executing the clone. If you don’t have assignable user permission in the target project, the issue will be unassigned.
Assign all issues to me: All cloned issues will be assigned to user executing the clone. If you don’t have assignable user permission in the target project, the issues will be unassigned.
Due to a technical limitation, we currently can’t check for assignable user permission for other users than the current user. As soon as this will be possible, we will add a user picker for the assignee field, so other users can be selected as assignee.
Fix Versions: In company-managed projects releases can be defined and selected in the issues fix version field. If you clone to a company-managed project, you can select releases to be set in the fix version field from the existing releases in the target projects. This selection list will be populated every time you select a new target project. If you select a team-managed project as target project, the field disappears as releases aren’t available in team-managed projects.
Due date: Select a due date to be set.
Original Estimate NEW : In company-managed projects, you can set a new value for the original estimate field. Please note that the inserted value has to be in the Atlassian time tracking format. If the format isn’t correct, an error message is displayed and you can’t proceed to the next screen. An example for a valid format would be 2w 3d 4h, which means 2 weeks, 3 days and 4 hours.
If you click on next, you will get to the second page where you can configure which child or linked issues you want to clone with the source issue.
Child Issues - select for cloning
Choose for child issues which ones to clone together with the parent. Issue type, key and summary are displayed in the checkbox list.
Child issues can be issues in epic for epics or sub-tasks for other issues.
There will only be those issues selectable which have an issue type available in the target project.
If you can’t select a child issue, its issue type is not available in the target project you have chosen on the screen before.
You can only select sub-tasks for which the parent issue has been selected as well for cloning. If you deselect a parent, its sub-tasks won’t be selectable anymore.
Child Issues - edit fields NEW
Like for the parent issue, it is also possible to edit certain fields for the child issues you want to clone.
Clone Attachments: If the child issue has attachment(s) and if you have create attachment permission in the target project, you can decide if you want to clone the attachments or not. By default, it is selected to clone attachments. If the field doesn’t appear, it either means that the respective child issue doesn’t have attachments, or that you don’t have the permission to add attachments in the target project.
Expand more details: By clicking on the expand icon on the right, you can display more details for the different child issues. If expanded, additional fields with their value for the source issue are displayed and an edit icon appears that opens another dialog to change fields for the child issue (see screenshot above):
Summary: Modify the summary of the child issue
Original estimate: Set a new original estimate for the child issue. The value added needs to be in the Atlassian time tracking format (e.g. 4w 2d for 4 weeks and 2 days)
Due date
Story points: This field can be set for stories only.
After clicking on the save button the new values are displayed on the cloning screen and will be set in the cloned issues.
Linked Issues - Parent Issue
If the source issue has other issues linked to it, they will be displayed in a checkbox list below the list of child issues on the dialog. You can choose from three different clone link options.
Clone Link Options:
Clone links only: This means that the target issue will be linked to the same issues than the source issue
Clone linked issues: Linked issues to source issue will be copied as well and linked to the target issue
Don’t clone links: Nothing happens with links. They won’t be considered at all for cloning
Below those options you find the checkbox list of linked issues. Like for child issues only those links will be considered which are checked in the list.
By default, the last option is selected and if that is the case, no issues are selectable in the checkbox list.
Linked Issues - Child Issues
For issues linked to the child issues displayed, it becomes a little bit more complicated. But you can clone those links as well. Like for linked issues to source issue, you have 3 options for link cloning of child issue links:
Clone child issue links: This means that the cloned child issues will be linked to the same issues than the child issues of the source issue
Recreate internal links after cloning: Internal links are links among child issues (see explanation below for details). If this option is chosen those internal links will be recreated after cloning. As an example, if child issue 1 is linked to child issue 2 below the source issue, then the clone of child issue 1 will be linked to the clone of child issue 2 afterwards
Don’t clone links: Nothing happens with child issue links. They won’t be considered at all for cloning
Below those options you find the checkbox list of issues linked to child issues. Like described already above, only those links will be considered which are checked in the list.
By default, the last option is selected and if that is the case, no issues are selectable in the checkbox list.
What does external/internal links of child issues mean?
As the cloning of child issue links can become complex, here is a table with examples for the different possibilities. Let’s assume we have a source issue with child issues A, B and C, and issues D and E, which are outside of the source issue, so not child issues.
Source Issue
Child: Issue A
Child: Issue B
Child: Issue C
Issue D
Issue E
Link | Type | Child Issue selected for cloning | Selected link option for child issue links | Result |
|---|---|---|---|---|
Issue A → Issue D | external | yes | Clone child issue links | Cloned issue A → Issue D |
no | Clone child issue links | no cloned issue A, no link created | ||
not relevant | Recreate internal links after cloning | no link created as link is not internal | ||
Issue B → Issue C | INTERNAL | yes | Clone child issue links | Cloned issue B → Issue C |
no | Clone child issue links | no cloned issue B, no link created | ||
Issue B: yes Issue C: yes | Recreate internal links after cloning | Cloned issue B → Cloned issue C | ||
Issue B: yes Issue C: no | Recreate internal links after cloning | no link created |
The child issue link checkboxes are only selectable when cloning of the link is possible at all. As an example, if you select to recreate internal links, all checkboxes for external links are disable and only internal links are selectable. If you deselect one of the checkboxes for child issue cloning, recreation of the respective internal link is no longer possible. Therefore, the related child issue link checkboxes are disabled.
Only links between child issues on the same level are considered as internal. So, only between child issue and child issue, or sub-task and sub-task. A link between a child issue and a sub-task of another child issue is considered as external.
If you have finished your settings, click on run to start the cloning. See this page for information on the result screen.