Display Linked Issues DC - Search and export

From Display Linked Issues DC 3.4.0 you can find issues by the content of the field in JQL and export the field’s columns with Jira’s CSV export.


Search by the field in JQL

Find issues that have a given issue in the field (replace Linked issues with the name of your field):

"Linked issues" ~ "ABC-1"

Find issues where the field is empty or not empty:

"Linked issues" is EMPTY
"Linked issues" is not EMPTY

Search works only for fields in links mode. In JQL mode the field is not indexed, and ~ finds nothing. To find the same issues, run the field’s JQL query itself in the issue search.

One-time setup: enable the searcher

Upgrading to 3.4.x does not change the indexing of existing fields. A Jira administrator enables search once per field:

  1. Go to Administration → Issues → Custom fields.
  2. Find the field, open the ⚙ menu and choose Edit.
  3. Set Search template to Linked issues searcher and click Update.
  4. Run a re-index (Administration → System → Indexing) so that existing issues get into the index.

Until these steps are done, JQL with the field returns nothing - search “does not work” not because of an error, but because the field has no searcher.

After the upgrade Jira may show a “Plugins” banner asking for a re-index. The banner comes from Jira itself; the app does not need a re-index after the upgrade. Re-index only after you set the searcher in step 3.

Permissions and limits

  • The index is built without the permissions of a user: it contains the keys of all linked issues.
  • Search results are filtered by Jira as usual - by the permission to browse the found issue. If an issue matched by the key of a linked issue the user cannot see, the result reveals only the fact of the link, not the content of the hidden issue.
  • At most Max issues keys of one field are put into the index (see Max issues).

Downgrade warning

Rolling back from 3.4.x to 3.3.0 breaks saved filters, dashboards and boards that use the field in JQL: 3.3.0 has no searcher for it. Remove the field from such filters before a downgrade.


Export to CSV

Jira’s issue navigator export Export → CSV (all fields) and Export → CSV (current fields) includes the field’s columns as text:

  • one value per linked issue, with the columns from the field settings;
  • only the linked issues visible to the user who exports;
  • at most Max issues linked issues per field.