Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Finding Dependencies Hidden in Linked Jira Issues

SnapJQL_3.png

Dependencies hide in plain sight

Jira issue links are easy to create and easy to ignore. A story is blocked by a platform task. A support ticket relates to a bug. A bug duplicates another bug. A change request causes follow-up work in a different project. Each link may be visible when someone opens the issue, but the dependency can disappear in a board, dashboard, or release review.

That is how delivery risk hides in plain sight. The information exists, but it is not part of the team's regular query.

Standard JQL can help with many filters, but dependency questions often require moving through links and inspecting the linked issues. The real question is not only "which issues are blocked?" It may be "which issues are blocked by unresolved work in another project?" or "which customer tickets relate to high-priority development bugs?"

Start by naming the relationship

Before building a dependency query, teams should agree on what their issue links mean. Jira sites often have link types such as blocks, is blocked by, relates to, causes, is caused by, duplicates, or is duplicated by. The names matter because direction matters.

If issue A blocks issue B, a query from A outward may answer a different question than a query from B inward. A release manager may care about work blocked by unresolved dependencies. A support lead may care about customer tickets that caused development work. A quality lead may care about duplicates connected to a known defect.

Without link discipline, advanced queries become noisy. With link discipline, they become a practical map of risk.

A realistic Jira scenario

Imagine a team preparing a payment release. The release board shows all planned stories as "In Progress" or "In Review." At first glance, the release looks manageable.

Then the team reviews linked issues. One story is blocked by a security review task in another project. Two bugs relate to an incident ticket that is still open. A third story has a "causes" link to a downstream documentation task that has not started. None of these dependencies were obvious from the release board alone.

The team builds a dependency review around link questions:

  • Which release issues are blocked by unresolved linked issues?
  • Which high-priority bugs relate to open support requests?
  • Which issues have links to work outside the release project?
  • Which linked issues are Done, and which still need attention?

This does not replace conversation. It gives the conversation a better agenda.

Look beyond the current issue

Linked issue reporting becomes more useful when it includes properties of the linked issue, not just the existence of a link. A dependency is more urgent if the linked issue is unresolved, high priority, assigned to a different team, or sitting in a blocked state. A duplicate link may be harmless if the original is resolved, but important if the original is still open and affects the same release.

Teams can also use linked issue context directly in issue views. A graph-style view can help people understand direction: which issue points to which, what the link type means, and whether the current issue is the blocker or the blocked item.

The point is to reduce the need for manual clicking. If every dependency review requires opening twenty issues one by one, it will not happen consistently.

This is especially useful across projects. A product story might be in one project, the platform dependency in another, and the customer ticket in a service project. Each team may have its own board, but the link between the issues is the shared delivery reality. Advanced link queries give the review a cross-project lens without requiring every team to reorganize its boards around the same structure.

Do not over-query messy links

Advanced link queries are only as useful as the link hygiene behind them. If teams use "relates to" for everything, dependency queries will be broad but vague. If they use "blocks" carefully, blocker reports become much more actionable.

A practical improvement is to define a small link taxonomy:

  • Use blocker links for work that prevents progress.
  • Use cause links when one issue created the need for another.
  • Use duplicate links only when the work truly represents the same underlying problem.
  • Use relates-to links sparingly for looser context.

This gives advanced JQL something meaningful to search.

Teams should also decide how often dependency views are reviewed. A daily operational queue may focus only on blockers. A weekly release review may include related support tickets and unresolved causes. A monthly improvement review may look for repeated duplicates or recurring causes. The same link data can support different rituals, but each ritual should have a clear question so the report does not become noise.

Clear review ownership matters too; someone should know which team is expected to act when a dependency appears.

One possible tool for this workflow

For teams that need advanced Jira queries across inward and outward issue links, link types, linked issue properties, remote link indexing, and relationship graph views, SnapJQL - Advanced JQL Functions & Properties is available on the Atlassian Marketplace.

Dependencies rarely announce themselves at the perfect moment. Teams find them earlier when link data is part of normal search, reporting, and release review.

0 comments

Comment

Log in or Sign up to comment
TAGS
AUG Leaders

Atlassian Community Events