- Overview
- Creating a Configuration
- Basic Settings
- Display Settings
- Display Options
- Portal Panel Options
- Next Steps
Overview
Each panel configuration controls:
- WHERE it appears - Display Module (places on the customer portal request page)
- WHEN it appears - Context Filters (portals, request types, JQL)
- WHAT it shows - Fields of the request, linked requests and link buttons
Creating a Configuration
- Go to Apps → Customer Portal Fields Panel 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: “Request details”, “Related requests”, “Useful links”
Description
- Optional field
- Up to 5,000 characters of static text
- Displayed below the panel title (if “Show Description” is enabled)
- Useful for a short note to customers about the panel
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 panels - disable a panel that is only needed during a migration or a campaign
- Debugging - isolate issues by disabling panels one at a time
Display Settings
Display Module
Choose where the panel appears:
| Module | Location |
|---|---|
| JSM Portal Panel | Request page, main column |
| JSM Portal Request Details Sidebar | Request page, right-hand details column |
| JSM Portal Header | Request page, above the page title |
| JSM Portal Subheader | Request page, below the page title |
| JSM Portal Footer | Request page, bottom |
Each configuration targets one of these 5 modules. Create multiple configurations for multiple locations.
See Modules for detailed information about each module type.
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 the number of linked requests. With an actor (Application (for JSM Portal) or a named account) it is the number of rows the customer sees; without an actor - Jira’s approximate count of what the viewer can see | Yes |
On the portal there is no Issue Navigator link.
Portal Panel Options
Settings that only portal panels have:
| Setting | Tab | What it does |
|---|---|---|
| Layout | Display Fields | Empty fields, colon after the field name, value under the name, date and date-time formats |
| Link buttons | Other | Up to 5 buttons at the top of the panel that open a URL in a new tab |
| Actor | Other | Whose permissions the panel reads Jira data with - see Actor |
| Translations | Translations | Texts of the panel in up to 10 other languages |
See Portal Panel Settings for the details of each setting.
Next Steps
- Testing Panels - Preview and debug your configurations
- Bulk Operations - Export, import, and manage configurations
- Data Sources - Request fields and linked requests
- Context Filters - Control when panels appear
- Portal Panel Settings - Layout, link buttons, request fields on the portal

