Update fields

The Update fields post function automatically updates a single or multiple issue fields on one or multiple target issues.

Additional field values can be inherited or manually set using the JWT expression editor.


⚒️ Configuration

Target issue

The issues to be updated. If a list of issue keys is passed, the update will be performed for every issue in the list.
The following options are available:

  • Current issue

  • Parent issue

  • Parser expression

When the option parser expression is selected, an expression parser input field is displayed and the input has to be an issue key or an issue list. Every issue in the given list will be updated.

Fields

Every supported field can either be set or cleared.

After selecting a field and clicking the Add button, you can select in the popup how to set the value. There are three or - when dealing with selectable fields - four options:

  • Copy field from current issue

  • Clear field value

  • Set field value manually - Read more about the JWT expression editor

  • The option Selected value is available for the following fields types:

    • Jira Software related fields like Sprint or Epic

    • User related fields like Assignee or Reporter

    • Version related fields like Affects- or Fix version/s

    • Component/s

    • Labels

    • Priority

    • Resolution

    • Security level

    • and all option based custom fields that are supported

Attachments

The Attachments section allows you to define which files from the current issue should be copied to the defined target issue(s).

You can choose between the following options:

Option

Description

All attachments

Select this option to copy all attachments from the current issue. You may limit it further by selecting specific file types (e.g., .docx, .pdf) from the document type dropdown.

Attachments filtered by regex

Enter a valid regular expression (e.g., .*\.png) to filter attachments by filename pattern. Only matching files will be copied.

Regular expressions are accepted with or without slash delimiters and regex options, e.g. .*\.png or /.*\.png/i (to accept mixed case file extensions), but not /.*\.png (missing final delimiter).


Attachments selected via parser expression

Use a JWT or Jira expression to programmatically define which attachments to copy. This allows for dynamic selection based on issue data, metadata, or business rules. For example, you can copy only attachments added by a specific user, those added after a certain date, or those with matching custom field values.

Transition attachments

Select this option to copy all attachments uploaded during the transition via the "Attachments" field. You may limit it further by selecting specific file types (e.g., .docx, .pdf) from the document type dropdown.

Only attachments uploaded through the Attachments field on the transition screen are supported.



There is a size limit for copying attachments. If any attachment exceeds 10MB, it will not be copied.

Copying of attachments might also fail due to a network error in the Atlassian infrastructure, e.g. when copying large amounts of attachments - please check the log, if you miss attachments in the copy target.

Run as

Select the user that will be used to execute the post function. By default, it is set to the current user that executes the transition.

The following options are available:

Option

Description

Selected user

Select a specific Jira user.

User in field

Select the field containing the user that will be used to execute the post function.


The configured user must have all necessary permissions to edit the target issue. When using the Jira Workflow Toolbox app user, this requirement is always fulfilled, as the App user has the required permissions.

Additionally, using the Jira Workflow Toolbox app user makes it possible to set or update fields even if they are not present on the screen. The Jira Workflow Toolbox app user can also modify issues that are normally restricted from editing.


Conditional execution

You can optionally specify a logical expression or a Jira expression depending on the chosen Parsing mode to define the circumstances (or conditions) under which the post function should be executed.

The result of the logical expression must return a boolean value of either:

  • true → the post function will be executed

  • false → the post function will not be executed

Using the conditional operator, even complex or multi-layered conditions can be constructed.

Make sure to learn more about defining logical expressions and browse through the various examples here: Logical mode


📚 Use cases and examples