Matrix custom field Documentation

Adding a new field

  1. Head to the custom field configuration page ( → Issues → Custom fields) and create a new field

    image-20250310-143129.png

  2. Select “Advanced” and pick either the single or multi-select Matrix custom field

    image-20250310-143117.png

  3. Give your custom field a name and put it on the appropriate screens

  4. Search for the custom field you just created and configure it (… → Contexts and default values → Edit custom field config)

    image-20250310-143721.png
    image-20250310-143758.png

  5. You can now give your X and Y axis a name and add options for both dimensions. Click “Preview” to show how the field will look like:

    image-20250310-143909.png

  6. Click “Submit” to save the configuration

Reporting

You can use all Matrix custom fields in JQL statements (and consequently in filters, Automation rules or any other JQL based control):

# perform a simple Text based match against either of the selected values (will match e.g. "Team" or "My Team") Rating ~ Team # search for a specific value in the X dimension or Y dimension # single select: matches exact value # multi select: matches if any value matches "Rating.xValues" = High "Rating.yValues" = Everyone # search based on the grid index (0-indexed), e.g. "Give me all issues where the Impact is higher than "Medium") # single select: matches based on the selected value # multi select: matches based on _any_ selected value (e.g. if _any_ of the options is higher than "Medium") "Rating.xCoordinates" > 2

News

Support for the Jira Service Management customer portal

It is now possible to make use of the Matrix CF in JSM!

  1. Simply create a new custom field just as explained above and associate it to the desired JSM Project’s screens

  2. Open the Project Settings (… → Project Settings) or ( → Projects → … -> Project Settings)

    Screenshot 2025-06-30 at 14.20.44.png

  3. Head to the Request Types page (Request management → Request types) and click on the desired Request type in the table

    Screenshot 2025-06-30 at 14.23.04.png

  4. Add the created custom field to the Request form configuration

    Screenshot 2025-06-30 at 14.30.20.png

  5. Save the changes and try it out by raising a new request of the configured Request type

Known limitations

  • Currently, the color tokens used for the color configuration are not supported in JSM. The colors can still be displayed but are slightly different compared to the usual colors in other views, since a fallback value is used.

Usual colors:

Screenshot 2025-07-02 at 12.05.34.png

Colors in JSM:

Screenshot 2025-07-02 at 12.07.41.png

 

  • The field can currently not be rendered in the portal view, which is why it defaults to standard text, making it still usable. However Atlassian is planning to support this soon: “…Please note that anonymous access and Jira Service Management portal view support are coming soon.”

Support

Please raise a ticket at our support system to let us know of any issues or feature requests.