Ensure that all required checklist items are completed before a work item can be transitioned to a specific status. This workflow validator enforces compliance with required checklist items by blocking work items from progressing until all mandatory steps are completed.

How it works

When a user attempts to transition a work item that has incomplete required checklist items, the validator will block the transition and display an error message. If a work item contains multiple checklists, the validator checks all of them. Every mandatory item across all checklists must be completed before the transition is allowed.

How to add the validator

Access the workflow editor

The first step depends on the type of your project.

For company-managed projects:

  1. Navigate to Space settings -> Workflows.
  2. Find the workflow you want to add the validator to, and click Edit workflow.

For team-managed projects:

  1. Navigate to Space settings -> Work types.
  2. Choose the work type you want to configure.
  3. Click Edit workflow.

Add the validator

Once you're in the workflow editor:

  1. Select the transition (arrowed line) where you want to add the validator, and click Add rule.

      2. In the configuration screen, click Checklists for Jira (Templates & Automation) under Marketplace Rules.

      3. Choose Checklists: Validate that all mandatory items are complete.

      4. Click Select.

Configure the validator

After selecting the validator, a configuration dialog appears where you can define its parameters:

  1. Choose the transition path
    Select the transition to which this validator should be applied, based on your workflow configuration.
  2. Customize the error message (optional)
    The error message field is pre-filled with a default message. You can customize this message to match your team's terminology or provide users with specific guidance.
  3. Click Add to apply the rule to the transition.

After configuring the validator, click the Update workflow button to save your changes.

This rule ensures that no required step is accidentally skipped, maintaining consistent quality standards across your team's workflow.