Contents 👇🏼

Overview

In some cases, you may want to prevent checklist edits when an issue reaches a specific workflow status. For example, once a work item moves to Done, you may want to lock the checklist to ensure no changes are made after the work is completed.

You can achieve this in two ways:

1. Smart Checklist property
   Use the com.railsware.SmartChecklistsEditingDisabled issue property to switch the checklist UI to read-only mode, optionally allowing edits only for specific user groups.

2. Jira workflow properties
   Use Jira’s native workflow permissions to block editing of the entire issue (including Smart Checklist) in certain statuses.

Smart Checklist property

Starting from Smart Checklist v7.8.0, you can control checklist editing using the issue property: com.railsware.SmartChecklistsEditingDisabled

Example:

This property can be set using a Jira automation rule.

Steps to configure automation rule

1. Create a personal access token.

   • Navigate to User icon → Profile → Personal Access Tokens → Create Token.

   • Copy token value.

2. Create an automation rule.

   • Go to Settings → Automation → Create rule

3. Add Trigger (for example, Issue transitioned from In progress to Done).

4. Add Conditions if needed.

5. Add Action.

   • Choose Set entity property.

   • Fill in the fields with the following values and Save:

Open

Set entity property action

6. Name your new Automation and Turn it on

You're done! Now every time an issue is transitioned to Done, Smart Checklist will be disabled for all users except those in allowedGroups (if configured) ✅

Jira workflow properties

Jira also allows restricting editing through workflow properties. To prevent editing of the entire issue including Smart Checklist, you can use: jira.permission.edit.denied property.

This property removes the permission to edit issues in that status for all users, including Jira admins.

Steps to add the property to the workflow

1. Navigate to Workflows → Edit Workflow → Switch to Diagram view.

2. In the Diagram view, select the status you want disable checklist editing for (e.g. Done).

3. Click Properties.

Open

Diagram view of the Project Workflow

4. Add property in the following format:

Open

Adding the workflow property to Done status

5. Confirm the property appears in the list.

Open

List of properties for the Done status

6. Return back to the workflow and Publish changes.

Done!✅ Now, every time an issue is transitioned to the Done, the issue (including Smart Checklist) will be disabled for editing for all users.

For more details on Jira workflow properties, see Atlassian’s documentation: https://support.atlassian.com/jira-cloud-administration/docs/use-workflow-properties/