Show Related Issues FAQ

What is Show Related Issues used for?

Show Related Issues displays a panel in your issue view containing other issues that match a JQL query you define. This allows you to see related issues based on common attributes without manually searching.

How do I create a Related Issue panel?

1. Navigate to Admin ⚙ > Apps > Show Related Issues
2. Click the "+ New Panel" button
3. Provide a name for your panel
4. Select projects and issue types where it should appear
5. Enter a JQL query to define which issues are related
6. Click Save and Confirm

Can I use issue variables in JQL?

Yes. You can use ${issue} to reference the current issue. For example:

"Epic Link" = ${issue.fields.parent.key}

This would show all issues with the same Epic parent.

What if the JQL query returns too many results?

The panel will load, but you may not see all results. We recommend refining your JQL query to return a more manageable number of related issues. Consider adding additional filters like status or date constraints.

How can I optimize Show Related Issues performance?

Complex JQL queries or queries that return large numbers of issues can impact loading time. Try:

• Simplifying your JQL query
• Adding more restrictive filters (e.g., status, date ranges)
• Limiting the number of results by targeting fewer projects or issue types