Linked Issues Condition

Use the Linked Issues Condition to control whether or not a user can transition an issue based on the status or resolution of linked issues.

There are several options available when setting up the Linked Issues Condition:

Status Checks

The Status radio button allows you to control the transition based on the status of any linked issues.

If the Status option is selected, the transition is only allowed if all linked issues of the selected link directions are in any of the selected statuses.

For example, you want a condition to only allow the transition of a story to Done if all is blocked by or is caused by linked issues are in the Done status.


Resolution Checks

The Resolution radio button allows you to control the transition based on the resolution of the linked issues.

If the Resolution option is selected, two options are available:

  • Any Resolution - Allows the transition if all linked issues have any resolution.
  • Select Resolution(s) - Allows the transition if all linked issues have any specified resolution.

For example, you want a condition to only allow the transition of an Epic to Done if all the issues in the epic and epic subtasks have a resolution.

Alternatively, you want to only allow an Epic to transition to Done when all issues in the epic and epic subtasks have the resolution Done. 

Use the Invert condition checkbox to reverse the above condition logic


You can add this condition to any transition except the Create transition.

  1. Select the Linked issues condition [ScriptRunner] condition.

    For details on how to navigate to ScriptRunner workflow functions, see Navigating to Workflow Functions.

  2. Enter a description of the condition in Note.
  3. Select the Link Directions you want the condition to look for.
  4. Select if you want to use Status or Resolution for the Checks on the linked issues.
  5. If you choose Status, enter the status values you want to check for.
    OR
    If you choose Resolution, select the Any resolution radio button to check if the issue has any resolution set, or choose Select resolution(s) and enter the required resolutions.
  6. Optionally, select to Invert Condition.
  7. Click Update.

The is epic of link direction can be used to control the ability to transition an epic based on the issues shown in the Issues in Epic section of the epic.

The subtask link direction can be used to control the parent issues ability to transition based on the linked subtasks.

Links with the same inward and outward direction names are not supported and cannot be selected from the Link Direction (Link Type) field.

Go to the 'Administration' > 'Issues '>' issue Linking' section to view your link type direction names.

On this page