Message Panel for Jira CloudAvailable Modules
Message Panel uses Atlassian Forge modules to display panels in different locations on Jira issue screens. Below are detailed descriptions of each module with visual examples showing how they appear in Jira.
Issue Panel
Location: Right sidebar on issue view screen
Characteristics:
- Main display location
- Collapsible/expandable panels
- Supports modal windows
- Best for detailed information
When to use:
- Main data displays
- Linked issues tables
- Detailed dashboards
Example: The screenshot shows a “Message panel” displayed in the right sidebar with issue information including summary, status, priority, dates, and other custom fields.
Issue Activity
Location: Activity feed timeline
Characteristics:
- Appears in activity/comments section
- Inline display only
- Mixed with comments and history
- Displays as a separate tab in the Activity section
When to use:
- Recent changes summary
- Activity-related info
- Timeline context
Example: The screenshot shows a “Message Panel” tab in the Activity section alongside “All”, “Comments”, “History”, “Work log”, and “Approvals” tabs. The panel displays issue information directly in the activity timeline.
Issue Context
Location: Right sidebar context panel
Characteristics:
- Appears in the right sidebar context panel
- Collapsible/expandable section
- Displays alongside other sidebar panels (Details, Automation, etc.)
- Fast access to contextual information
When to use:
- Optional information
- Quick reference data
- Supplementary details
- Contextual issue information
Example: The screenshot shows a “Message Panel” section in the right sidebar context panel, positioned below “Automation” and displaying issue details in a collapsible format.
Issue Action
Location: Issue actions toolbar
Characteristics:
- Adds custom action button to the toolbar
- Opens on-click
- User-initiated interaction
- Appears alongside standard actions like “Create subtask” and “Link work item”
When to use:
- User-triggered displays
- On-demand queries
- Interactive tools
- Actions that require explicit user interaction
Example: The screenshot shows a “Message panel” button in the issue toolbar, positioned after “Create subtask”, “Link work item”, and “Create” buttons. Clicking this button opens the message panel.
Enabling Modules
Global Module Settings
- Go to Apps → Message Panel Settings
- Click the Module Settings tab
- Toggle modules on/off:
- Issue Panel - Displays messages as a collapsible panel on the issue view page
- Issue Activity - Shows messages in the activity stream section of the issue
- Issue Context Panel - Displays messages in the context panel on the right side of the issue view
- Issue Action - Adds an action button to the issue toolbar for viewing messages
- Click Save Settings
Note: Disabled modules won’t appear anywhere, even if configurations target them. Configure which modules are enabled for displaying message panels in your Jira instance. These settings control where and how the panels appear in the issue view.
Per-Configuration Module Selection
Each configuration specifies which module to use:
- Edit or create a configuration
- Find Display Module setting
- Select one module from dropdown
- Save configuration
Module Behavior
Visibility Rules - Where and When Panels Appear
Understanding panel visibility requires knowing TWO key concepts:
WHERE = Display Module (Issue Panel, Activity, Context, or Action) WHEN = Context Filters (Projects, Issue Types, JQL conditions)
A panel appears when ALL of these conditions are met:
- Module is enabled globally - The module type must be turned on in Module Settings
- Configuration targets that module - The panel config must select that specific module
- Project filter matches - Issue must be in selected projects (if any specified)
- Issue type filter matches - Issue must have selected type (if any specified)
- Display JQL matches - Issue must match JQL condition (if any specified)
- User field condition matches - Current user must be in specified fields (if any specified)
Example: You have a panel configured with:
- Display Module: Issue Panel
- Projects: “Marketing”
- Display JQL:
status = "In Progress"
This panel will appear in the right sidebar (Issue Panel location) ONLY when viewing issues from the “Marketing” project that have status “In Progress”.
Multiple Panels
Multiple configurations can target the same module:
- Ordering: By weight (lower first), then alphabetically
- Collapsible: Each panel can be collapsed independently (Issue Panel only)
Module-Specific Features
Issue Panel - Modal Windows
Display panels in modal dialogs:
Options:
- Show in Modal - Enable modal window
- Modal Button Text - Custom button label
- Button Appearance - Visual style
- Modal Size - Small/Medium/Large/X-Large
- Auto-Open - Open automatically on issue load
- Show Once Per Issue - Only auto-open once
Example use case: Critical blockers warning with auto-open and danger appearance.
Next Steps
- Configuration Guide - Set up panels
- Dynamic Templates - Add dynamic content
- Template Examples - Ready-to-use examples
- Rovo Integration - AI-powered analysis
