Display Modules

Display Linked Issues shows its tables in several places of the Jira issue view.

Module Overview

Display Linked Issues registers 5 display modules. Each configuration targets exactly one of them.

Module Location
Issue Panel Main column of the issue view, below the description (title “Linked issues”)
Issue Activity A “Linked issues” tab in the Activity section
Issue Context Collapsible “Linked issues” block in the right-hand column
Issue Action Item in the issue actions menu that opens the table
Custom Field A Linked issues custom field on the issue view

Jira Modules

Issue Panel

Location: Main column of the issue view, below the description

Issue Panel Example

Features:

  • Collapsible/expandable panels
  • Best for detailed information

Use for: The main table of linked issues, for example blockers or child work


Issue Activity

Location: Tab in Activity section

Issue Activity Example

Features:

  • Appears alongside Comments, History tabs
  • Inline display
  • Good for activity context

Use for: Related work you check while reading comments and history, for example related incidents


Issue Context

Location: Right sidebar context panel

Issue Context Example

Features:

  • Collapsible section
  • Alongside Details, Automation panels
  • Quick access

Use for: Reference data, supplementary details


Issue Action

Location: Issue toolbar

Issue Action Example

Features:

  • Custom action button
  • Opens on click
  • User-initiated

Use for: Large tables or JQL results you open only when needed


Custom Field Module

Location: A Linked issues custom field shows the linked issues table on the issue view - in the main column or in the Details section, as the issue layout decides

Features:

  • Per-context configuration - a different table for each field context
  • Shown on the issue view only, not on create forms or the customer portal; users cannot edit it
  • Configurations whose field or field context was deleted are disabled automatically

Use for: Linked issues tables placed among the fields of the issue

For full setup instructions, see Custom Fields.


Enabling Modules

Global Settings

  1. Go to Apps → Display Linked Issues settings
  2. Click the Module Settings tab
  3. Toggle modules on/off
  4. Click Save Settings

Disabled modules won’t display anywhere, even with configurations targeting them.

The page carries one toggle per display module - 5 in total, exactly the modules listed in Module Overview. Until the settings are saved for the first time, every module is on. A module switched off shows nothing and cannot be chosen in new configurations.

Per-Configuration

Each configuration specifies its display module:

  1. Edit or create a configuration
  2. Find Display Module dropdown
  3. Select one module
  4. Save

Visibility Rules

A panel appears when ALL conditions are met:

  1. Module is enabled globally
  2. Configuration targets that module
  3. Project filter matches (if specified)
  4. Issue type filter matches (if specified)
  5. Display JQL condition matches (if specified)
  6. Display condition matches (if specified)

Example: Panel with:

  • Module: Issue Panel
  • Projects: “Marketing”
  • Display JQL: status = "In Progress"

Shows in the issue panel only for Marketing issues with status “In Progress”.


Multiple Panels

Multiple configurations can target the same module. Here’s how they interact:

  • Order: By weight (lower first), then alphabetically by name for equal weights
  • Collapsing: Each panel collapses independently (Issue Panel only)
  • Independence: Each panel loads its own data source and renders independently
  • No limit: There is no hard limit on the number of panels per module, but performance degrades with many active panels

Ordering with Weight

Use the Weight setting to control display order. Valid range is 0..1000 - lower weight appears earlier. A new configuration gets 10 × the number of existing configurations, so it goes below the existing ones.

Weight Position
0 Appears first (top)
1 - 999 Sorted ascending
1000 Appears last (bottom)

Panels with the same weight are sorted alphabetically by name.

Tip: Use weight increments of 10 to leave room for future insertions.


Next Steps