SearchMate - Advanced JQL Search for Linked Issues
Breadcrumbs

Advanced Link Filter Options

Linked Issue Filter Function

SearchMate adds an extended search function that allows you to list issues based on the results of a saved Jira filter. The function works directly inside the Jira Issue Navigator and uses the filter output as the starting point for resolving linked relationships.

SearchMate automatically interprets link types and link directions. This means inward and outward definitions are handled internally, and all supported link types are evaluated consistently unless a specific direction is provided.


issueKey in linkedItemsFromFilter(<FilterID>, <linkNameOrLinkId>, <LinkDirection>)
For example: issueKey in linkedItemsFromFilter("10307", "Blocks", "inward")

Parameter

Required(Yes& No )

Description

FilterID

Yes

issues returned by the saved filter.
Since no link type is specified, all link types and both directions (inward/outward) are included.

Link name or link id

No

Returns only the issues linked with the Blocks link type.
Link direction is automatically resolved, so both blocks and is blocked by relationships are included.

Link direction

No

Returns only the issues that have an inward Blocks relationship to the issues returned by the saved filter.
Direction is explicitly defined, so only is blocked by connections are returned.

image-20251229-124201.png

This queries work in two steps:

1. Running the base JQL query

The text inside the quotation marks is evaluated first.
In this example, issueKey in linkedItemsFromFilter("10307") executes Filter 10307 and returns all

2. Finding linked work items

SearchMate then examines the links of the issues returned by the saved filter and retrieves all items connected through the Blocks link type.

When the search is executed, the results appear in the standard Issue Navigator.
The Linked Work Items column displays the items identified through the relationship check, allowing you to see connection paths without opening individual issues.
The Linked Work Items column is not shown by default; you need to add it manually.