Conditions
Last modified: 06 February 2023The Workflow Constructor supports a wide variety of predefined conditions. These conditions let you describe the basic criteria that must be met to run a workflow rule.
Define the base criteria by dragging conditions to the Prerequisites section of the workflow rule.
When adding multiple conditions, each condition is automatically connected with a logical AND operator. This means that the prerequisite for running the workflow rule is only met when every condition in the Prerequisites section are met.
You can combine conditions in different ways using building blocks. To learn more, see Building Blocks.
Use the Check for additional conditions action to perform additional checks during the transaction. For more information, see Check for Additional Conditions.
Comment Is Added
This condition checks whether a comment is added to the current issue during the transaction that begins when the workflow is triggered. If a comment is added, the condition is met.
An additional Issue parameter lets you choose which issue the comment must be added to as the prerequisite.
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue the comment must be added to as the prerequisite. The following options are available:
|
Comment Is Deleted
This condition checks whether a comment is permanently deleted from the current issue during the transaction that begins when the workflow is triggered. If any comment is permanently deleted, the condition is met.
When a comment is deleted but can still be restored, this condition is not met.
An additional Issue parameter lets you choose which issue the comment must be deleted from as the prerequisite.
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue the comment must be deleted from as the prerequisite. The following options are available:
|
Attachment Is Added
This condition checks whether a file is attached to the current issue during the transaction that begins when the workflow is triggered. If a file is attached, the condition is met.
An additional Issue parameter lets you choose which issue the attachment must be added to as the prerequisite.
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue the attachment must be added to as the prerequisite. The following options are available:
|
Attachment Is Removed
This condition checks whether an attachment is removed from the current issue during the transaction that begins when the workflow is triggered. If a file is removed, the condition is met.
An additional Issue parameter lets you choose which issue the attachment must be removed from as the prerequisite.
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue the attachment must be removed from as the prerequisite. The following options are available
|
Issue Link Is Added
This condition checks whether a link to another issue is added to the current issue during the transaction that begins when the workflow is triggered.
An additional Issue parameter lets you choose which issue the link must be added to as the prerequisite. This condition can be further constrained with an optional Link type parameter.
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue the link must be added to as the prerequisite. The following options are available:
| ||||||||
Link type | Determines which link type must be present to satisfy the condition.
|
Issue Link Is Removed
This condition checks whether a link to another issue is removed from the current issue during the transaction that begins when the workflow is triggered.
An additional Issue parameter lets you choose which issue the link must be removed from as the prerequisite. This condition can be further constrained with an optional Link type parameter.
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue the link must be removed from as the prerequisite. The following options are available:
| ||||||||
Link type | Determines which link type must be present to satisfy the condition.
|
Work Item Is Added
This condition checks whether a work item is attached to an issue during the transaction that begins when the workflow is triggered. If a work item is attached, the condition is met.
An additional Issue parameter lets you choose which issue the attachment must be added to as the prerequisite.
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue the work item must be added to as the prerequisite. The following options are available:
|
Work Item Is Deleted
This condition checks whether a work item is deleted from an issue during the transaction that begins when the workflow is triggered. If a work item is deleted, the condition is met.
An additional Issue parameter lets you choose which issue the work item must be removed from as the prerequisite.
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue the work item must be deleted from as the prerequisite. The following options are available:
|
Issue Has Specific Attributes
This condition checks an issue to see whether one of its attributes meets the specified condition. The condition can be configured to check the current issue or a predefined reference issue.
The condition can be configured to check the issue description, comments, linked issues, or attachments.
For any of these attributes, you have the option to check whether the attribute is empty or not.
For attributes that store a collection (comments, linked issues, or attachments), you can compare the current number of items in the collection to a predefined amount.
Sample scenarios supported by this block include:
Checking the issue for at least one duplicate link.
Performing an action only when the issue description is empty.
Finding issues to update when they contain more than ten comments.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Issue | Determines whether to check the current issue or check the attributes in a specific issue. The following options are available:
| ||||||||||||
Attribute | Determines which issue attribute to check for the specified condition. The following options are available:
| ||||||||||||
Condition | Determines which condition must apply to the specified attribute in order for the workflow rule to continue processing. The following options are available:
| ||||||||||||
Amount | Stores the amount used to evaluate the number of items stored in the selected attribute. This option is only visible when the Condition setting is set to is fewer than, is greater than, or is equal to. |
Date Field Matches Specified Criteria
This condition checks the value in a specified date field and determines whether it matches the criteria defined in the block.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Issue | Determines whether to check the current issue or check the field in a specific issue. The following options are available:
| ||||||||||
Field | Specifies which field to check. The available options for this setting are restricted to the set of fields that store dates or dates and times in the projects to which the workflow is attached. | ||||||||||
Happens after | Sets the starting point after which the selected date field is considered. If the value that is stored in the selected field happens before the criteria specified in this setting, the workflow rule will not run. The following options are available:
| ||||||||||
Happens before | Sets the end point before which the selected date field is considered. If the value that is stored in the selected field happens after the criteria specified in this setting, the workflow rule will not run. The following options are available:
|
Issue Is Created Within a Specific Time Frame
This condition checks an issue to see whether it was created within the time frame defined in the block.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
| ||||||||||
Created after | Sets the starting point after which the issue creation will match the condition. If the issue is created before the criteria specified in this setting, the workflow rule will not run. The following options are available:
| ||||||||||
Created before | Sets the end point before which the issue creation will match the condition. If the issue is created after the criteria specified in this setting, the workflow rule will not run. The following options are available:
|
Issue Is Updated Within a Specific Time Frame
This condition checks an issue to see whether it was updated within the time frame defined in the block.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
| ||||||||||
Updated after | Sets the starting point after which the issue update will match the condition. If the issue update occurs before the criteria specified in this setting, the workflow rule will not run. The following options are available:
| ||||||||||
Updated before | Sets the end point before which the issue update will match the condition. If the issue update occurs after the criteria specified in this setting, the workflow rule will not run. The following options are available:
|
Issue Is Created by a Specific User
This condition checks an issue to see whether it was created by a specific user.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
| ||||||||
Created by | Determines which user needs to have created the issue to satisfy the condition. The following options are available:
|
Issue Is Updated by a Specific User
This condition checks an issue to see whether it was updated by a specific user.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
| ||||||||
Created by | Determines which user needs to have updated the issue to satisfy the condition. The following options are available:
|
Issue Is Assigned to a Project
This condition checks an issue to see what project it does or does not belong to.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
| ||||||||
Condition | Determines which condition to verify. The following options are available:
| ||||||||
Project | Determines which project is considered to satisfy the specified condition. The following options are available:
|
Field Matches Specified Criteria
This condition check the specified custom field to see whether it matches the criteria defined in the block. The following conditions are supported:
A value for the specified field is set or not.
The field currently stores a specific value or not.
The value for the field changes from one value to another.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
| ||||||||||||
Field | Determines which field is checked. The selection is limited to the fields that are available in the projects that the workflow is attached to. | ||||||||||||
Condition | Determines which condition must apply to the specified field in order for the workflow rule to continue processing. The following options are available:
| ||||||||||||
Value | Determines which value must be stored in the selected field to satisfy the condition. This setting is only shown when the Condition is set to is or is not. | ||||||||||||
From | to | Determines the starting and ending values that must be present for the selected field to satisfy the condition. These settings are only shown when the Condition is set to changes. |
Issue Attribute Contains a Keyword
This condition checks the current issue to see whether it contains the specified word or words. The condition can be configured to check any combination of issue summary, description, comments, or summaries in linked issues.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
| ||||||||||||
Attributes | Determines which attributes to check for the keywords that are specified in the condition block. The following options are available:
You can check for issues that contain keywords in any combination of these attributes. | ||||||||||||
Keywords | Stores the keywords that must be contained in at least one of the specified issue attributes for this condition to be met. This setting also supports references to variables that are available in the current context. To browse the list of available fields, click the Insert reference icon. To learn more about references to local variables in workflow rules, see Inserting References to Fields. |
New Issue is Created
This condition checks an issue to see whether it becomes reported in the current transaction. If the issue remains as a draft, this condition is not met.
Issue Becomes Resolved
This condition checks an issue to see whether changes applied to the issue in the current transaction assign it to a state that is considered to be resolved. If the issue remains in an unresolved state, this condition is not met.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
|
Issue Becomes Unresolved
This condition checks an issue to see whether changes applied to the issue in the current transaction assign it to a state that is considered to be unresolved. If the issue remains in a resolved state, this condition is not met.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
|
Issue Has Tag
This condition checks whether the specified tag has been added to an issue.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
| ||||||||
Tag | Stores the name of the tag that must be added to an issue to satisfy this condition. This setting also supports references to variables that are available in the current context. To browse the list of available fields, click the Insert reference icon. To learn more about references to local variables in workflow rules, see Inserting References to Fields. |
Issue Exists or Is Created
This condition checks whether an issue has already been reported or becomes reported in the current transaction. If the issue remains as a draft, this condition is not met.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
|
Issue Is Resolved
This condition checks whether an issue is currently assigned a state that is considered to be resolved. If the issue remains in an unresolved state, this condition is not met.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
|
Issue Is Starred
This condition checks whether an issue is starred on behalf of the current user
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
|
Issue Is Visible
This condition checks whether a specified user has access to read the issue. If the specified user doesn't have access, this condition is not met.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Issue | Determines which issue to check for the condition. The following options are available:
| ||||||||
User | Determines which user the issue should be visible to. The following options are available:
|
Project is Archived
This condition checks whether the specified project has been archived. If the project is active, this condition is not met.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||
---|---|---|---|---|---|---|---|---|---|
Project | Determines which project is considered to satisfy the condition. The following options are available:
|
User Can Remove Vote from Issue
This condition checks whether the specified user is allowed to remove their vote from an issue.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
User | Determines which user should be able to remove a vote from the issue. The following options are available:
| ||||||||||
Issue | Determines which issue to check for the condition. The following options are available:
|
User Can Vote for Issue
This condition checks whether the specified user is allowed to vote for an issue.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
User | Determines which user should be able to vote for the issue. The following options are available:
| ||||||||||
Issue | Determines which issue to check for the condition. The following options are available:
|
User Has Role
This condition checks whether the user has been granted the specified role in a specific project.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
User | Determines which user should be assigned the specified role in a project. The following options are available:
| ||||||||||
Role | Determines which role must be assigned to the specified user for this condition to be met. The following options are available:
| ||||||||||
Project | Determines which project is considered to satisfy the condition. The following options are available:
|
User Is Banned
This condition checks whether the specified user account has been banned and no longer has access to the application.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
User | Determines which user account should be checked. The following options are available:
|
User Is a Member of a Group
This condition checks whether the specified user is a member of a specific group.
Use the following settings to apply additional constraints to this condition block:
Setting | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
User | Determines which user account should be checked. The following options are available:
| ||||||||||
Group | Stores the name of the group in which the specified user must be a member for this condition to be met. The following options are available:
|