- Module Overview
- Jira Modules
- Custom Field Module
- Enabling Modules
- Visibility Rules
- Multiple Panels
- Next Steps
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

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

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

Features:
- Collapsible section
- Alongside Details, Automation panels
- Quick access
Use for: Reference data, supplementary details
Issue Action
Location: Issue toolbar

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
- Go to Apps → Display Linked Issues settings
- Click the Module Settings tab
- Toggle modules on/off
- 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:
- Edit or create a configuration
- Find Display Module dropdown
- Select one module
- Save
Visibility Rules
A panel appears when ALL conditions are met:
- Module is enabled globally
- Configuration targets that module
- Project filter matches (if specified)
- Issue type filter matches (if specified)
- Display JQL condition matches (if specified)
- 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
- Configuration Basics - Create panel configurations
- Custom Fields - The Linked issues custom field
- Context Filters - Control when panels appear

