Since v 3.9.5 Smart Checklist add-on stores checklist content in Jira Issue Properties.

With this change, we intended to drastically simplify add-on set-up and first user experience.

Using the "Checklists" custom field is still possible and supported as it gives additional and valuable benefits to checklist users.

Look at the comparison chart of what features are supported within different storage models below.

Features support per Smart Checklist add-on storage type

Feature

Issue Properties

Custom Field 🚀

Checklist items states

(tick)

(tick)

Full-screen Editor

(tick)

(tick)

Markdown support

(tick)

(tick)

Details per checklist items

(tick)

(tick)

Agile board issue detail view

(tick)

(tick)

Templates

(tick)

(tick)

Control Position of Checklist Rendering

(tick)

(tick)

Manage add-on visibility per project

(tick)

(tick)

Change via API

(tick)

(tick)

Search and JQL support

(tick)

Validate before transition

(error)

(tick)

Track checklist changes

(error)

(tick)

Update Checklist by workflow state transition

(error)

(tick)

Clone Jira Issue with checklists content

(error)

(tick)

Checklist on Confluence Page

(error)

(tick)

Progress on Agile Board

(use "Smart Checklist Progress" field)

(error)

(tick)

As you see, the main checklist functionality is supported with Issue Properties and right after add-on installation on the Jira instance.

However, to access checklist content via API or from 3rd party tools - you need to set up the "Checklists" custom field. Just follow the instructions below.

How to set up "Checklists" custom field to store Smart Checklist add-on values by default.

Understanding of Issue Property and "Checklists" custom field synchronization

Add-on uses our database as first priority storage and then syncs it with "Issue Property" and the "Checklists" custom field(if present).

When a checklist is changed, it is updated everywhere: in our database, in issue property, and in the custom field.

If you think that the checklists content is not synchronized properly between all the storages, we recommend to run Data Synchronization.