Configuration Basics

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

  1. Go to Apps → Customer Portal Fields Panel 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: “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