Comment Required Validator

A workflow validator that forces users to enter a comment during a transition. If the user does not enter a comment, a custom error message will be displayed.

The comment should be entered on the transition screen (in the Comment section) of the transition. You can also customize the validation so that the members of certain groups are allowed to omit the comment.

To add 'Comment Required Validator' to a transition:

  1. Click Edit for the workflow that has the transition you wish to configure the validator on.

  2. In the Workflow Designer, select the transition.

  3. Click on Validators in the properties panel.

  4. Click on Add validator.

  5. Select Comment Required Validator from the list of validators.

  6. Click on Add to add the validator on the transition.

  7. Input a message in the Error Message.

  8. If you want to omit some groups, select the groups from the Available groups list and click on Add>> to add groups to the Allowed groups list.

  9. Click on Add to add the validator to the transition.

On the Service Management portal view of a request, the customer will not see the Error message when the validator fails. This is due to a known limitation (JSDSERVER-5822) with Atlassian.

You are viewing the documentation for Jira Data Center/Server.

On This Page

Figure 1 - Comment Required validator


When you add this validator to a transition and trigger the transition, the add-on checks for a value in the Comment field of the Transition screen. The comment field is suffixed with a red asterisk. If it is blank, the configured validation error message will be displayed. However, users from the selected groups can progress to the destination status without entering a comment.

Note that this validator does nothing if the transition is being made through SOAP, because the progressWorkflowAction method does not let you specify a comment.

Validator Scope

To execute this validator based on the result of a groovy expression see Conditional execution using Groovy expression.

Show asterisk (*) if the condition returns true upon showing the screen

By default, the red asterisk is not shown on the screen against the Comment field when using Conditional Validation, because the condition's value might depend on what the user will later enter on the transition screen. Check this option to show the asterisk if the condition returns true upon entering the transition or issue creation screen. This is useful when the condition is not dependent on the other fields shown on the screen (e.g. it only depends on the issue type, the current user's project role, etc.).