How To Filter Linked Issues In Jira

If you encounter any issues while trying to rephrase the text, please respond with the error message: “Unable to process the request due to encountered difficulties.”

It can be difficult to manage a project and stay organized with all of the related and interconnected issues. However, with the right tools, this task becomes much more manageable. Luckily, Atlassian’s Jira Software offers a helpful feature called Linked Issues to efficiently track and manage these issues. In this blog, we will provide a guide on how to use the Jira feature to filter linked issues.

What is a Linked Issue in Jira?

Before we dive into the steps, let’s clarify what a linked issue is. In Jira, you can link one issue to another, showing the relationship and providing a handy way to reference and navigate to the connected issues directly. These links can represent a variety of relationships, such as duplicate, blocked, clone, or relate.

Filtering Linked Issues in Jira

Filtering linked issues in Jira requires a bit of JQL (Jira Query Language), which is a simple scripting language for Jira. JQL allows you to define what you’re looking for in Jira using words, operators, and values.

Step 1: Open Issue Navigator

First, open the issue navigator by clicking on “Issues” in the top menu, then “Search for Issues”.

Step 2: Switch to Advanced Search

For filtering linked issues, you’ll need to switch to “Advanced search”. You can find this option in the top right corner of the issue navigator.

Step 3: Enter Your JQL Query

Now it’s time to enter your JQL query. To filter linked issues, you can use the “issueLinkType” function in your JQL query. The basic syntax is:

issueLinkType = "link-description" AND issue in linkedIssues("issue-key")

Replace “link-description” with the type of link you are looking for (like “is blocked by” or “duplicates”), and “issue-key” with the key of the issue you want to see linked issues for.

For example, to find all issues that are blocked by issue “PROJ-123”, you would use:

issueLinkType = "is blocked by" AND issue in linkedIssues("PROJ-123")

Step 4: Run the Query

Click the “Search” button to run your query. If done correctly, you should now see a list of linked issues based on the criteria specified in your JQL query.


And there you have it – a simple and effective way to filter linked issues in Jira using JQL. Remember, mastering JQL can take time, so don’t be discouraged if it feels complicated at first. With practice, it becomes a powerful tool for managing and filtering issues in your projects.