YouTrack Standalone 2021.4 Help

Conditions

The 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 all of the conditions 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.

Comment Is Deleted

This condition checks whether a comment is deleted from the current issue during the transaction that begins when the workflow is triggered. If any comment is deleted, the condition is met.

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.

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.

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. This condition can be further constrained with an optional Link type parameter.

Setting

Description

Link type

Determines which link type must be present to satisfy the condition.

  • When set to Any link type, the condition is met when the issue is linked to any other issue using any link type.

  • To limit the condition to a specific link type, select a link type from the list.

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. This condition can be further constrained with an optional Link type parameter.

Setting

Description

Link type

Determines which link type must be present to satisfy the condition.

  • When set to Any link type, the condition is met when any type of issue link is removed from the issue.

  • To limit the condition to a specific link type, select a link type from the list.

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.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

Attribute

Determines which issue attribute to check for the specified condition. The following options are available:

Option

Description

issue description

Checks whether the specified condition applies to the issue description.

comments

Checks whether the specified condition applies to the collection of comments that have been added to the issue.

linked issues

Checks whether the specified condition applies to the collection of links that have been added to the issue. When this option is selected, an additional setting lets you choose which link types should be considered.

  • When set to any link type, the workflow checks for links of any type.

  • To limit the condition to a specific link type, select a link type from the list.

attachments

Checks whether the specified condition applies to the collection of files that have been attached to the issue.

Condition

Determines which condition must apply to the specified attribute in order for the workflow rule to continue processing. The following options are available:

Option

Description

is not empty

Checks whether the selected attribute stores any data.

is empty

Checks whether the selected attribute doesn't store any data.

is fewer than

Checks whether the number of items stored in the selected attribute is fewer than a specified amount. This option is unavailable for the issue description attribute.

is greater than

Checks whether the number of items stored in the selected attribute is greater than a specified amount. This option is unavailable for the issue description attribute.

is equal to

Checks whether the number of items stored in the selected attribute is equal to a specified amount. This option is unavailable for the issue description attribute.

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

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:

Option

Description

any date

The starting point used to determine whether the date field matches the specified criteria can be any date.

the rule is triggered

The date and time when the workflow rule is triggered is used as the starting point.

the value stored in another field

The value that is stored in a second date field is used as the starting point. When used, an additional field for storing the second date field is added to the condition block.

a fixed date

The specified date and time is used as the starting point. When used, an additional field for storing the fixed date is added to the condition block.

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:

Option

Description

any date

The end point used to determine whether the date field matches the specified criteria can be any date.

the rule is triggered

The date and time when the workflow rule is triggered is used as the end point.

the value stored in another field

The value that is stored in a second date field is used as the end point. When used, an additional field for storing the second date field is added to the condition block.

a fixed date

The specified date and time is used as the end point. When used, an additional field for storing the fixed date is added to the condition block.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

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:

Option

Description

any date

The starting point for evaluating the issue creation can be any date.

the rule is triggered

The date and time when the workflow rule is triggered is used as the starting point.

the value stored in another field

The value that is stored in a specific field is used as the starting point. When used, an additional field for storing the date field is added to the condition block.

a fixed date

The specified date and time is used as the starting point. When used, an additional field for storing the fixed date is added to the condition block.

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:

Option

Description

any date

The end point for evaluating the issue creation can be any date.

the rule is triggered

The date and time when the workflow rule is triggered is used as the end point.

the value stored in another field

The value that is stored in a separate field is used as the end point. When used, an additional field for storing the date field is added to the condition block.

a fixed date

The specified date and time is used as the end point. When used, an additional field for storing the fixed date is added to the condition block.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

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:

Option

Description

any date

The starting point for evaluating the issue creation can be any date.

the rule is triggered

The date and time when the workflow rule is triggered is used as the starting point.

the value stored in another field

The value that is stored in a specific field is used as the starting point. When used, an additional field for storing the date field is added to the condition block.

a fixed date

The specified date and time is used as the starting point. When used, an additional field for storing the fixed date is added to the condition block.

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:

Option

Description

any date

The end point for evaluating the issue creation can be any date.

the rule is triggered

The date and time when the workflow rule is triggered is used as the end point.

the value stored in another field

The value that is stored in a separate field is used as the end point. When used, an additional field for storing the date field is added to the condition block.

a fixed date

The specified date and time is used as the end point. When used, an additional field for storing the fixed date is added to the condition block.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

Created by

Determines which user needs to have created the issue to satisfy the condition.

The following options are available:

Option

Description

Use the current user

The workflow checks to see if the issue was created by the current user.

Use the value from a custom field

The workflow checks the specified field to see if the issue was created by the user who is currently stored as the value for the field. When used, an additional field for storing the user field is added to the condition block.

Use a specific user

The workflow checks to see if the issue was created by the specified user. When used, an additional field for storing the user is added to the condition block.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

Created by

Determines which user needs to have updated the issue to satisfy the condition.

The following options are available:

Option

Description

Use the current user

The workflow checks to see if the issue was updated by the current user.

Use the value from a custom field

The workflow checks the specified field to see if the issue was updated by the user who is currently stored as the value for the field. When used, an additional field for storing the user field is added to the condition block.

Use a specific user

The workflow checks to see if the issue was updated by the specified user. When used, an additional field for storing the user is added to the condition block.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

Condition

Determines which condition to verify. The following options are available:

Option

Description

project is

The workflow checks to see if the issue is assigned to the specified project.

project is not

The workflow checks to see if the issue is not assigned to the specified project.

Project

Determines which project is considered to satisfy the specified condition. The following options are available:

Option

Description

Use a specific project

The workflow checks to see if the condition is true for the issue in the selected project. When used, an additional field for storing the project is added to the condition block.

Field Matches Specified Criteria

This condition check the specified custom field to see whether it matches the criteria defined in the block. All of 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

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:

Option

Description

is set

Checks whether the selected field stores any value.

is not set

Checks whether the selected field stores an empty value.

is

Checks whether the field is set to a specific value.

is not

Check whether the field is set to any value other than the value that is specified in the condition.

changes from

Checks whether the value for the selected field transitions from the initial value to a target value in the current transaction.

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, is not, or changes from.

  • When the Condition is changes from, an additional setting lets you specify the value that the field must transition to.

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

Attributes

Determines which attributes to check for the keywords that are specified in the condition block. The following options are available:

Option

Description

Summary

The workflow checks for the specified keywords in the issue summary.

Description

The workflow checks for the specified keywords in the issue description.

Comments

The workflow checks for the specified keywords in the issue comments.

Summaries in linked issues

The workflow checks for the specified keywords in the summaries of any issues that are linked to the current issue.

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.

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.

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.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

Tag

Stores the name of the tag that must be added to an issue to satisfy this condition.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

Issue Is Resolved

This condition checks whether an issue is currently assigned a state that is considered to bbe 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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

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 whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

User

Determines which user the issue should be visible to.

The following options are available:

Option

Description

Use the current user

The workflow checks to see if the issue is visible to the current user.

Use the value from a custom field

The workflow checks the specified field to see if the issue is visible to the user who is currently stored as the value for the field. When used, an additional field for storing the user field is added to the condition block.

Use a specific user

The workflow checks to see if the issue is visible to the specified user. When used, an additional field for storing the user is added to the condition block.

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:

Option

Description

Use the project for the current issue.

The workflow checks to see if the current issue belongs to a project that is currently archived.

Use a specific project

The workflow checks to see if the specified project is archived. When used, an additional field for storing the project is added to the condition block.

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:

Option

Description

Use the current user

The workflow checks to see if the current user is able to remove a vote from the issue.

Use the value from a custom field

The workflow checks the specified field to see if the user who is currently stored as the value for the field is able to remove a vote from the issue. When used, an additional field for storing the user field is added to the condition block.

Use a specific user

The workflow checks to see if the specified user is able to remove a vote from the issue. When used, an additional field for storing the user is added to the condition block.

Issue

Determines whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

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:

Option

Description

Use the current user

The workflow checks to see if the current user is able to vote for the issue.

Use the value from a custom field

The workflow checks the specified field to see if the user who is currently stored as the value for the field is able to vote for the issue. When used, an additional field for storing the user field is added to the condition block.

Use a specific user

The workflow checks to see if the specified user is able to vote for the issue. When used, an additional field for storing the user is added to the condition block.

Issue

Determines whether to check the current issue or check the attributes in a specific issue.

  • With Use the current issue, the condition checks any issue that is taken into consideration by the workflow rule.

  • With Use a specific issue, and additional setting lets you choose which issue to check.

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:

Option

Description

Use the current user

The workflow checks to see if the current user is assigned the specified role.

Use the value from a custom field

The workflow checks the specified field to see if the user who is currently stored as the value for the field is assigned the specified role. When used, an additional field for storing the user field is added to the condition block.

Use a specific user

The workflow checks to see if the specified user is assigned the specified role. When used, an additional field for storing the user is added to the condition block.

Role

Determines which role must be assigned to the specified user for this condition to be met.

Project

Determines which project is considered to satisfy the condition. The following options are available:

Option

Description

Use the project for the current issue.

The workflow checks to see if the user is assigned the specified role in the project that the current issue belongs to.

Use a specific project

The workflow checks to see if the user has the specified role in a specific project. When used, an additional field for storing the project is added to the condition block.

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:

Option

Description

Use the current user

The workflow checks to see if the current user has been banned.

Use the value from a custom field

The workflow checks the specified field to see if the user who is currently stored as the value for the field has been banned. When used, an additional field for storing the user field is added to the condition block.

Use a specific user

The workflow checks to see if the specified user has been banned. When used, an additional field for storing the user is added to the condition block.

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:

Option

Description

Use the current user

The workflow checks to see if the current user is a member of the specified group.

Use the value from a custom field

The workflow checks the specified field to see if the user who is currently stored as the value for the field is a member of the specified group. When used, an additional field for storing the user field is added to the condition block.

Use a specific user

The workflow checks to see if the specified user is a member of the specified group. When used, an additional field for storing the user is added to the condition block.

Group

Stores the name of the group in which the specified user must be a member for this condition to be met.

Last modified: 29 October 2021