Configure Modifications
What Are Modifications?
Modifications allow you to define how the Issue Create Screen should behave when the specified conditions are met. You can also set alternative modifications, which will run if the conditions are not met. This ensures flexibility in tailoring the behavior of the screen to different scenarios.
Types of Modifications
Here are the modification types you can use:
- setFieldValue: Prepopulate a field with a specific value.
- setFieldReadOnly: Make a field read-only.
- setFieldEditable: Make a field editable.
- setFieldHidden: Hide a field.
- setFieldVisible: Make a field visible.
- setFieldRequired: Make a field mandatory.
- setFieldOptional: Make a field optional.
- setFieldDescription: Add or update a field’s description.
- setFieldName: Rename a field.
- setFieldOptionsVisible: Show specific options in a dropdown field.
- setFieldOptionsHidden: Hide specific options in a dropdown field.
Supported Fields for Modifications
You can apply these modifications to the following field types:
- Datepicker
- Datetime
- Float
- Multi-checkboxes
- Multi-select
- Multi-user picker
- People
- User picker
- Radio buttons
- Select
- Textarea
- Textfield
- URL
- Assignee
- Components
- Description
- Fix Version
- Labels
- Priority
- Reporter
- Summary
- Issue Type
- Due Date
- Target Start
- Target End
- Affects Versions
Adding Modifications
- Open the Behaviour Builder in Templating.app. Read our guide for more info.
- Select the Description Template you want to modify.
- Under the “Modifications” section, choose the desired modification type.
- Specify the field and value (if applicable) for the modification.
- (Optional) Add alternative modifications that will apply when the conditions are not met.
- Save your template.
Adding Multiple Modifications
You can add multiple modifications and alternative modifications to a single template, allowing you to handle complex scenarios.
Troubleshooting
- Warning Sign Next to a Field Type: If you see a warning icon, this means the field is not present on the create screen of the selected issue types. Update your Jira configuration to include the field.
- Missing Fields: If a field is not listed, it is not yet supported. Field support is determined by Atlassian’s capabilities. Learn more about supported fields on Atlassian’s API reference page.