[All Adaptavist Apps]

Page tree

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

What are Behaviours?

Behaviours give you more control over fields in Jira. A field configuration customizes how fields behave. However, a behaviour in ScriptRunner allows you to take that field customization further, defining how fields behave for issues in a given project or issue context.

How to use Behaviours

Behaviours let you extend the standard field configuration options available in Jira and give you the power to use contextual information like current field values, workflow step name, or user details as conditional logic.

You can create behaviours to:

  • Prefill/preformat a template for users to follow when an issue is created.

  • Make a custom field read-only depending on the workflow state.

  • Dynamically make calls to external data sources based on user selections when an issue is created.

  • Hide a custom field depending on the value of another custom field.

Behaviours give you more options to customize how fields in Jira behave, so you can show/hide additional fields when a particular option is selected. For example, you might want to use a behaviour to control what information certain users can edit or view. As a project manager, you may want complete control over which issues go into a sprint. Using behaviours, you can make the Sprint field read-only for anyone except users in the Project Managers role, ensuring only project managers can add issues to sprints.


Before you start

See our Using Behaviours in ScriptRunner training module to learn about setting up and using behaviours.


Before setting up a behaviour be sure to read through the Behaviour Limitations documentation. This can also help if you’re having problems getting your behaviour to work.



  • No labels