The Adaptavist Group LogoDocumentation

Behaviours Supported Fields and Products

Note:Jira terminology changes

As noted in our March 2026 release note, ScriptRunner for Jira Cloud is aligning with Jira's updated terminology across the app UI and documentation.

Some Atlassian documentation - particularly the​ Jira UI modifications ​ guide referenced throughout this page - still uses the previous terminology. As a result, this page currently reflects that older terminology with only minimal updates, and will be revised in due course.

Supported Jira products

Jira ProductSupported CapabilitySupported on Cloud
JiraCompany-managed spaces
Team-managed spaces
Jira Service Management
Note: Behaviours are only supported in the Create view for Business company-managed spaces.

Supported Jira view-specific limitations

ViewSpace type
Jira global issue create (Create view type)Company-managedTeam-managed
Jira issue view (View/Edit view type)Company-managedTeam-managed
Jira issue transition (Transition view type)Company-managed
Note: Refer to Atlassian's Jira UI modifications documentation for more details.

Supported fields on Jira

Note:Behaviours mapping wildcard limitations

You can select the wildcard option for either All spaces or All work types only; due to an Atlassian limitation, both options cannot be chosen simultaneously.

Using the 'All spaces' field on a behaviour means only 1 context is used for spaces. If it is used with several Work Types, then this 1 context is multiplied by the number of work types selected. If we enable this behaviour for multiple view types, this value is also multiplied by the number of view types. For example:
FieldSelectedContexts
SpaceAll Spaces (100 spaces)1
Work Type/sStory, Bug, Task3
Jira ViewsIssue Create, Issue View(Create, View/Edit view types)2
Total6

Developing Behaviours on Cloud and adding more functionality to this feature remains a high priority for the ScriptRunner team! Behaviours can be applied to Sub-tasks and the supported fields outlined below for the Global Issue Create, Issue, and Transition views (Create, View/Edit, Transition view types). We continually strive to support the functionality provided by Atlassian. For more information, please refer to Atlassian's UI Modifications guide.

Modifications can only be made to supported fields, depending on your selected view, as outlined in the Create, Issue, and Transition view sections below.

Note: System Fields and Custom Fields

In Behaviours, some Jira-native system fields can be custom field types. An example of this is the Labels field, which is a Jira-native system field. Only Jira-native system fields are supported, so your Behaviours may not function correctly if you have created a custom field of typeLabels. System field types are identified in each of the Supported Fields tables below, while custom field types are marked with a (error).

Create view supported fields (Create view type)

Issue view supported fields (View/Edit view type)

Note:Hidden fields

On the Issue view, fields with no value are automatically hidden when they are set to read-only. For example, empty read-only date picker, text (single), select list (single and multiple), checkbox, radio, and number fields are hidden. This is the default behaviour when the user does not have permission to edit the issue.

Field/methodsSystemField TypesetNamegetNamesetDescriptiongetDescriptionsetVisibleisVisiblesetValuegetValuesetReadOnlyisReadOnlysetRequiredisRequiredsetOptionsVisibilitygetOptionsVisibility
affects versions
assignee
cascading select

components

checkboxes
date picker
date time picker

description
fix versions
labels
multi select
multi user picker
number
original estimate
paragraph
parent
people
priority
project picker
radio buttons
reporter
single select
status
summary
text field
url
user picker

Note:Story Points field does not perform in the same way as a regular number field

The Story Points field must not be handled as a generic supported Number field. In Jira Cloud, Story Points is a Jira-managed special field, and Jira does not reliably enforce read-only behavior for it in the Issue View.

Supported views for issue view

Behaviours configured to run on the Issue View are triggered when accessed through one of the views outlined below, which are highlighted with example images:

  • full page issue



  • board issue



  • backlog issue



  • list issue



  • Issues issue



  • search issue (global search)

    image href="media/search-issues.png" width="600" placement="break"/>

Transition view supported fields (Transition view type)

Note:Atlassian's new transition dialog

Behaviours on transition view run only in the new Issue transition dialog, as defined by Atlassian's UI Modifications API. If this has not been enabled for your instance, then Behaviours on transition view will not work.

Field/methodsSystemField TypesetNamegetNamesetDescriptiongetDescriptionsetVisibleisVisiblesetValuegetValuesetReadOnlyisReadOnlysetRequiredisRequiredsetOptionsVisibilitygetOptionsVisibility
affects version
assignee
cascading select
checkboxes
date picker
date time picker
description
fix versions
issue type
labels
multi select
multi user picker
number
original estimate
paragraph
parent
priority
project picker
radio buttons
reporter
resolution
single select
summary
text field
url
user picker

Supported fields on JSM

Developing Behaviours on Cloud and adding more functionality to this feature remains a high priority for the ScriptRunner team! Behaviours can be applied to Sub-tasks and the supported fields outlined below for the Request Create Portal on Jira Service Management. We continually strive to support the functionality provided by Atlassian. For more information, please refer to Atlassian's UI Modifications guide.

Modifications can only be made to supported fields, depending on your selected view, as outlined in the section below.

Note: System Fields and Custom Fields

In Behaviours, some Jira-native system fields can be custom field types. An example of this is the Labels field, which is a Jira-native system field. Only Jira-native system fields are supported, so your Behaviours may not function correctly if you have created a custom field of typeLabels. System field types are identified in each of the Supported Fields tables below, while custom field types are marked with a (error).

Request create portal (Preview)

Field/methodsSystemField TypesetNamegetNamesetDescriptiongetDescriptionsetVisibleisVisiblesetValuegetValuesetReadOnlyisReadOnlysetRequiredisRequiredsetOptionsVisibilitygetOptionsVisibility
cascading select

date picker
date time picker
description
due date
labels
multi select
number
paragraph
priority
single select
summary
text field
user picker

Search documentation

Start typing to search the docs.