Configuration Basics

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

  1. Go to Apps → Display Linked Issues settings
  2. Click Create panel
  3. Configure settings across tabs
  4. 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