Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
If you change the target project, it is immediately validated whether

When opening you open the Epic Clone dialog you can adjust , you have the option to modify the cloning settings for the parent issue (the one from which you accessed the dialog from) on the first initial screen.

Dialog if target project is a team-managed project:

Image RemovedImage Removed

Dialog if target project is a company-managed project (Epic):

Image RemovedImage Removed

Target Project: Select the target project for your clone. You will only see projects in the select list you have access to and where you have create permission.

Target project selection

Info

Cloning typically occurs within the same project by default. Nonetheless, Epic Clone offers the flexibility to clone across projects as well. By selecting the checkbox, you can search and select a new target project for the cloned issues.

Project_selection_1.pngImage AddedProject_selection_2.pngImage AddedProject_selection_3.pngImage Added

Notes for target project selection:

Only projects accessible to you will be displayed in the selection list.

When you switch the target project, the system promptly verifies if the issue type of the source issue is

available

present in the

selected target

newly selected project and checks your permission to create issues within that project. If

it

either condition is not

available this error message appearsImage RemovedSummary: Set

met, an error message will be displayed.

Image Added

Dialog if target project is a team-managed project:

Cloud_first_screen_team_managed.pngImage Added

Dialog if target project is a company-managed project (Epic):

Cloud_First_Screen_Classic_1.pngImage AddedCloud_First_Screen_Classic_2.pngImage Added

Edit fields

Summary: Define the summary for the cloned issue. The summary of the source issue is displayed by defaultoriginal issue's summary is automatically shown.

Epic Name: Epics in In company-managed projects have the , epics come with an epic name field. If When you clone an epic from a company-managed project, you can set have the option to specify the epic name field for the cloned new epic. The By default, the epic name of from the source original epic is displayed by default in this casesuch instances.

Find in description: You can search for text in have the option to locate specific text within the description field of the issue and replace substitute it with different content for the cloned duplicated issue with another text. This is useful especially when you work with feature proves particularly beneficial when utilizing placeholders in the description of template issues. You can easily replace them with the actual text during It allows for a seamless transition from placeholders to the desired text upon 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

Status
colourPurple
titlenew
: If the source issue has attachment(s) and if contains attachments and you have permission to create attachment permission attachments in the target project, you can decide if you want have the option to choose whether to clone the attachments or not. By default, it is selected set to clone attachments. If you do not see the field doesn’t appear, it indicates that either means that the source issue doesn’t have lacks attachments , or that you don’t have lack the permission privilege 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 When cloning a source issue with an established parent link, you have the option to decide whether you wish to replicate this parent link to the new newly created issue or not. This particular field only appears when a is only visible in the presence of an existing parent link exists.

Labels: Existing labels of the source issue will be displayed by default. You can select additional labels from the existing ones in your instance 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 , you have the ability to define and choose components within the issues. If you clone When cloning to a company-managed project, you can conveniently select components to be set from the existing components ones already present in the target projectsproject. This selection list will be populated every automatically updates each time you select choose a new target project. If you select However, if you opt for a team-managed project as the target project, the component field disappears as components aren’t available vanishes since components are not supported 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.

InfoDue 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

Status
colourPurple
titlenew
: Assign a user to the cloned issue. The default value shows the current assignee of the source issue. You can only choose users with permission to be assigned to issues in the target project. If you switch the target project and the current assignee lacks this permission, the field will reset. Not selecting a user will lead to an unassigned cloned issue.

Fix Versions: In company-managed projects, releases can be defined designated and selected chosen in the issues fix version field. If you clone When cloning to a company-managed project, you can have the option to select releases to be set assign in the fix version field from the existing defined releases in the target projectsproject. This selection list of selections will be populated every automatically filled each time you select pick a new target project. If However, if you select designate a team-managed project as the target project, the field disappears as releases aren’t available will vanish since releases are not supported in team-managed projects.

Due date: Select a due date to be set.

Original Estimate

Status
colourPurple
titlenew
: In company-managed projects, you can set a new value for have the ability to update the original estimate field . Please note that the inserted value has to be in with a new value. It is important to adhere to the Atlassian time tracking format . If the format isn’t correct, when entering the new value. Failure to follow the correct format will result in an error message is displayed and you can’t proceed , preventing you from advancing to the next screen. An example for For instance, a valid format would could be "2w 3d 4h, which means " representing 2 weeks, 3 days, and 4 hours.

If you click By clicking on "next," you will get be directed to the second page where . Here, you can configure which specify the child or linked issues that you wish to replicate along with the source issue. The progress indicator on top can also be clicked to proceed to the next screen.

Child issues

Cloud_Second_Screen_top.pngImage Added

Child Issues - keep in source project

When dealing with child issues you want to clone with the source issue.

Image RemovedImage RemovedImage Removed

originating from various projects, you have the option to choose between cloning them within their original project or transferring them all to the designated target project. Simply activate the toggle to retain these cloned issues in their respective projects. By default, all issues will be duplicated to the specified target project.

Link between source issues and cloned issues

Status
colourPurple
titlenew

This option can be enabled to establish an issue link between original issues and cloned ones. Similar to the "clones / is cloned by" relationship familiar in the default Jira clone function, you can also define such a link for the issues cloned using Epic Clone. Upon activation, a dropdown menu appears, allowing you to choose the link type for the issue links.

Cloud_Second_Screen_find_and_replace.pngImage Added

Child Issues - modify issue summaries

Status
colourPurple
titlenew

The find and replace functionality for child issue summaries allows users to search for a specific word or phrase and replace it with another term across all child issue summaries. This feature streamlines the process of updating information consistently within multiple child issues.

For instance, in the provided example screenshot, the word '<type of user>' is replaced with 'developer' in all child issue summaries. This capability enhances efficiency by enabling users to make bulk changes to text elements swiftly and accurately. The preview of the issues summary is displayed immediately when the search term is found.

Moreover, users can also add a prefix and suffix to all child issue summaries. This additional functionality offers flexibility in customizing the content of the summaries according to specific requirements or conventions. By incorporating prefixes and suffixes, users can further tailor the information displayed in the child issue summaries to align with their project needs.

Child Issues - select for cloning

Choose

for

which child issues

which ones

to clone

together

along with the parent.

Issue

The checkbox list displays the issue type, key, and summary

are displayed in the checkbox list

.

Child issues can either be

issues in epic for epics

epics within an epic or sub-tasks for other issues.

Panel
panelIconIdatlassian-note
panelIcon:note:
bgColor#DEEBFF
There will only be those issues selectable which have
  • Only the issues with an issue type

available
  • existing 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.

PanelpanelIconIdatlassian-notepanelIcon:note:bgColor#DEEBFF
  • will be selectable.

  • 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

Status
colourPurple
titlenew

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

contains attachments and you possess the permission to create attachments 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

have the option to choose whether to replicate the attachments. The default setting is to replicate the attachments. If you do not see the field, it indicates that either the specific child issue lacks attachments or you lack the authorization to include attachments in the target project.

Expand

more details

and edit: By clicking on the expand icon

on

next to the

right

issue summary, you can

display

reveal more details

for

about the

different

various child issues.

If

When expanded, additional fields along with their

value

corresponding values 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

    will be shown. Clicking on the edit icon located on the right allows you to make inline edits to the following fields:

    • Summary: Revise the child issue's summary.

    • Assignee: Choose from users with the necessary permission to be assigned to issues in the target project.

    • Original estimate: Define a fresh original estimate for the child issue.

    The value added needs to be in
    • Ensure the added value follows 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
    • attribute is exclusive to stories.

    After

    Upon clicking

    on

    the save button, the

    new

    updated values

    are displayed

    will appear on the cloning screen and will be

    set in the cloned issues.

    applied to the cloned issues.

    Cloud_Second_Screen_child_issues_edit.pngImage Added

    Child Issues - reorder

    Status
    colourPurple
    titlenew

    The Epic Clone feature allows for convenient reordering of child issues in the list through a simple drag-and-drop functionality. By rearranging the sequence of child issues, users can define a new order that will be applied when cloning the issues. Additionally, the flexibility extends to sub-tasks, enabling users to easily change their parent issue within the list using the same drag-and-drop method.

    In cases where the position of an issue becomes invalid, such as placing a sub-task at the top of the list without a parent, the system promptly responds with an error message displayed at the top of the issue list. This error notification ensures that the issue's position is reset to a valid state, maintaining the integrity of the cloning process.

    Cloud_Second_Screen_child_issues.pngImage Added

    Child Issues - reset

    To revert any modifications made on the screen or rearrangements of child issues, simply click on the reset icon located at the top right corner. This feature is visible only when alterations have been applied. By clicking the reset icon, the child issues on the page will be reloaded, and the field values will be restored to their default values.

    Cloud_Second_Screen_reset.pngImage Added

    Linked Issues - Parent Issue

    If the source issue has other linked issues linked to it, they will be displayed appear in a checkbox list below the child issue list of child issues on the dialog. You can choose from have three different clone link options .to choose from:

    Clone Link Options: 

    • Clone links only: This means that option links the target issue will be linked to the same issues than as the source issue.

    • Clone linked issues: Linked issues to source issue will be copied as well and linked This option copies and links the issues linked to the source issue to the target issue.

    • Don’t clone links: Nothing happens with With this option, no action is taken on the links. They won’t be are not considered at all for cloning.

    Below those Following these options, you will find the a checkbox list of linked issues. Like for Similar to child issues, only those the checked links in this list will be considered which are checked in the listtaken into account.

    By default, the last option is selected and if that is the casechosen. In this scenario, no issues are selectable can be selected in the checkbox list.

    Linked Issues - Child Issues

    For When dealing with issues linked to the child issues displayed, it becomes a little the process can become a 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 complex. However, it is possible to replicate these links. There are three choices available for cloning child issue links:

    • Clone child issue links: This means option ensures that the cloned child issues will be linked to the same issues than as the child issues of the source issue.

    • Recreate internal links after cloning: Internal links are links refer to connections among child issues (see refer to the explanation below for further details). If this option is chosen those internal links will be recreated after cloning. As an exampleOpting for this alternative will result in the recreation of internal links after cloning. For instance, if child issue 1 is linked to child issue 2 below under the source issue, then the clone of child issue 1 will be linked to the clone of child issue 2 afterwardssubsequently.

    • Don’t clone links: Nothing happens with This choice means that no action will be taken regarding child issue links. They won’t will not be considered for cloning at all for cloning

    Below those options you find the
    • .

    Following these options, you will encounter a checkbox list of issues linked to child issues. Like described already aboveAs mentioned earlier, only those links will be considered which the links that are checked in the this list will be taken into account.

    By default, the last option is selected and if that is the casepreselected. In this scenario, no issues are selectable can be selected 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

    Status
    colourPurple
    titleinternal

    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.

    Note

    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.

    Result Screen

    During cloning you can see the progress and how, step by step, the issues are cloned. On the left, the source issues are displayed, in the middle you see a spinner when cloning is not completed and a (tick) icon if the cloning is done. On the right side you see a link to the cloned issue and can directly navigate to it (link opens in a new tab).

    On top you see the issue that is currently in progress either for cloning, or setting a link to the new parent issue.

    Image Removed

    When cloning is completed, you can quickly navigate to each source or target issue by using the displayed links.

    Image Removed