The Linked Items Extender pulls in issues that are linked to issues already in the structure. Linked issues will be placed beneath the current issues in the structure's hierarchy.

Structure with Linked Items Extender

When using the Linked Items Extender, some issues may appear in your structure more than once. In the example above, "Task A" appears twice, because it blocks Story 1 and Story 2.

Adding a Linked Items Extender

To add a Linked Items Extender, open the Add menu and select Extend.

Add and extend generator

This will display the Extend generator options. Select Linked Items.

Extend generator options

Configuring the Generator

Each Linked Items Extender can be customized to create exactly the hierarchy you need.

Linked Issue Extender settings

Runs As

Unable to render {include} The included page could not be found.

Link Type

Allows you to specify which links to add to your structure.

Link Direction

Defines which side of the link is the parent issue and which is the sub-issue.

If this option is checked, links will be updated as you move issues in your structure:

  • Moving a linked issue from beneath one issue to another will sever the original link and create a new link.
  • Deleting a linked issue from the structure will sever its link.
  • Copying an issue under another issue will create a new link.

You can change up to 100 issues with a single move. If you need to update more than 100 issues, simply move them in chunks of 100 or fewer.

Please be aware that it may take up to several minutes to process all changes if 100 issues are moved at one time.

Extend Levels

Allows you to specify which levels in the hierarchy the extender should be applied to:

  • Levels are based on the placement of the generator, where "Level 1" is the level the generator is located on, "Level 2" is the level beneath that, and so on.
  • Linked issues will only be added for those issues within the selected range.

Place the generator on

Unable to render {include} The included page could not be found.

If a level is grayed out, it means it is not possible to place the generator on that level.

See Generator Scope to learn more.