...
| Info |
|---|
Related Issues are currently only available on Jira Cloud. If you would like to see this feature added to the Server version of the app please send us a message. |
| Table of Contents |
|---|
Related issues allow you to see other issues which are related to your work. It allows you to easily define which issues are related and where this information should be displayed.
For example you can see :
- See what other issues were reported by the same user in Service desk projects
...
- Highlight top priority blockers for a project.
It is all highly configurable with JQL queries and simple templating and you can fit the queries to your team needs.
| Table of Contents |
|---|
Issue view
Whenever you open a Jira issue you'll see a new section on the left called Related issues.
It's organized in tabs and you can click on them to unfold the list of matching issues. Configuration of the tabs is described in the next section.
| Info |
|---|
Please keep in mind that at most 100 issues will be displayed per each tab. If there is an error in the query the tab won't be displayed. |
Configuration
Related issues configuration page link is in the left hand menu.
The configuration page consists of entries. It also has a checkbox that allows to enable or disable the related issues functionality.
Each entry has a name and a corresponding JQL query. It can also be configured to display in certain issues by using the another JQL query for filtering.
Default entries
After installation you'll notice that configuration is populated with sample entries that are useful in many projects. It can also be used as an inspiration for you own related issue entries.
Adding entries
To add a new entry scroll to the bottom of the configuration page and click on the green Add button.
A new empty entry form is displayed:
| Field | Description | Example |
|---|---|---|
| Name of the relation |
...
A human readable label that will be displayed on the tab in the issue view. This field is required. |
...
| High priority stories |
| Related issue match |
...
A JQL query that controls the results |
...
displayed in the tab in the issue view. It supports templating described in the next subsection. | type=Story and priority=High | |
| Only show for isssues that match the filter | A JQL query that allows you to show the tab only in the issues that match this query. You can leave it blank to show the tab for all the issues. | For example to only show the |
...
| tab for stories set your filter to: |
Only show for isssues that match the filter is a JQL query that allows you to show the tab only in the issues that match this query. You can leave it blank to show the tab for all the issues.
...