Overview
Each panel configuration controls:
- WHERE it appears - Display Module (issue view surfaces and the Linked issues custom field)
- WHEN it appears - Context Filters (projects, issue types, JQL, display condition)
- WHAT it shows - Display fields of the current issue and a table of linked issues
Creating a Configuration
- Go to Apps → Display Linked Issues settings
- Click Create panel
- Configure settings across tabs
- Click Save
Basic Settings
Name
- Required field
- Must be unique across all configurations
- Displayed as panel title (if “Show Name” is enabled)
- Max 250 characters
- Examples: “Blockers”, “Related Bugs”, “Epic Progress”
Description
- Optional field
- Supports dynamic templates with issue data
- Displayed below the panel title (if “Show Description” is enabled)
- Useful for admin notes or dynamic context
Example:
This issue has {{ linkedIssues | len }} related items
Enabled
Toggle to enable/disable the panel without deleting the configuration.
- Enabled - Panel is active and will display when conditions match
- Disabled - Panel is hidden but configuration is preserved
Common use cases for disabling:
- Maintenance mode - temporarily hide panels during system changes
- Staged rollout - create configurations in advance, enable when ready
- Temporary tables - disable a table that is only needed during a release or a migration
- Debugging - isolate issues by disabling panels one at a time
Display Settings
Display Module
Choose where the panel appears:
| 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 |
Each configuration targets one of these 5 modules. Create multiple configurations for multiple locations.
See Modules for detailed information about each module type.
Display Limits
| Setting | Description | Range | Default |
|---|---|---|---|
| Rows Per Page | Issues shown per page in table | 1-100 | 10 |
| Max Issues | Maximum issues to load from query | 1-1,000 | 50 |
Note: Rows Per Page controls pagination display. Max Issues controls how many issues are fetched from Jira API - the JQL search pages through Jira results until it reaches Max Issues (up to 1,000). Set Max Issues high enough to show all relevant issues.
Weight
Controls display order when multiple panels target the same module:
- Lower weights appear first
- Same weight - panels with equal weight are sorted alphabetically by name
- Range: 0 to 1000 (negative values are rejected)
- Default for a new configuration: 10 × the number of existing configurations, so a new panel goes below the existing ones
Example:
- Panel A: weight = 0 (appears first)
- Panel B: weight = 10 (appears second)
- Panel C: weight = 100 (appears last)
Ordering strategy: Use weight increments of 10 (e.g., 10, 20, 30) - new configurations follow the same step - and keep 0 free, so you can still push a panel to the top later.
Display Options
Configure what elements appear in the panel:
| Option | Description | Default |
|---|---|---|
| Show Name | Display panel title | Yes |
| Show Description | Display description below title | Yes |
| Show Count | Display total issue count badge - the approximate total from Jira, not the number of rows loaded | Yes |
| Show JQL Link | Add link to open results in Issue Navigator | No |
Next Steps
- Testing Panels - Preview and debug your configurations
- Bulk Operations - Export, import, and manage configurations
- Data Sources - Linked issues by link types or by JQL
- Context Filters - Control when panels appear
- Templates - Dynamic content syntax

