Validate that the Checklist is Not Empty

This validator blocks a transition unless there are checklist items, either on a Local or Global Checklist.

Company-managed Projects

To set the workflow validator:

1. Navigate to Project Settings > Workflows

2. Click the pencil icon to edit the workflow.
   

   

3. Select Diagram mode and click on the transition where you want to add the validator.

4. Click on Validators.
   

   

5. Click Add validator.
   

   

6. Select the Checklist is not empty validator and click Add.
   

   

7. Click Add again to confirm creation of the validator.

8. Click Publish draft to save the changes.
   

   

9. Test the validator by attempting to transition an issue which does not meet the criteria. The transition will fail.

Troubleshooting Validators

Checklists for Jira uses work item entity properties to provide the following features:

• Block workflow transition if checklist is incomplete

• Basic JQL search

• Display checklist progress in Agile board and Search results

Therefore, the Checklist must be able to set work item entity properties. This is enabled by default. However, if a jira.permission.* workflow property has been set on a workflow step, Checklists may not be able to set issue entity property.

For example, the following property will prevent Checklists from setting work item properties, and features listed above won't work correctly:

Removing the jira.permission.* workflow property and using the standard Jira permissions to control who can edit the work item will allow the Checklist functions to work.

Team-managed Projects

You can create a rule in a Team-managed project that will block a transition unless there are items in the checklist.

To create the rule:

1. Navigate to Project settings > Work types.
   

   

    

2. Select the appropriate work type. Use the Search all fields box to find the Checklist Completed custom field and drag it to the appropriate place on the layout. Click Save changes.
   

   

    

3. Click on the Edit workflow button.
   

   

    

4. Click Rule.
   

   

    

5. Select Validate details as the Rule type, and choose Validate a field. Click Select.
   

   

    

6. Select the appropriate transition.

7. Use the Validate that field dropdown to select Isn’t empty.

8. Select Checklist Text from the For fields(s) list.
   

   

9. Click Add.

10. Click the Update workflow button to publish the rule.