On this page:

Didit Custom Fields Overview

In order to see these custom fields on your Jira issues, you will need to add them to your screens. To add custom fields to screens in company managed projects, you will need Jira admin permission. If you do not have this permission, reach out to your organization’s Jira admin for help. Before considering this, though, we recommend reading our best practices documentation around custom fields.

You can use all these fields in various automation rules. Follow the link to find out more.

Didit tasks completed percentage

This is a number type field which will show the percentage complete but without the ”%” symbol. The field value is 0 until a user completes or skips a task. If there are multiple checklists attached to the Jira issue, the number will aggregate.

Skipped Tasks field example
Skipped Tasks field example

Didit checklist completed

This field will turn from “no” to “yes” when a checklist is completed.

Skipped Tasks field example
Skipped Tasks field example

Didit Skipped Tasks

Contains the number of skipped tasks in the checklist. This could be useful to send alerts if too many checklist tasks are skipped. The field’s value is 0 until users skip a task.

Skipped Tasks field example
Skipped Tasks field example

Didit Last Comment

Contains the last note on a checklist, not the last comment on an individual checklist task. It works for public checklist comments as well as ones in Jira and/or Confluence. The field is empty until a user leaves a note.

Max characters

This field contains a maximum of 244 characters. If the note exceeds this, the field will not update.

Last comment field example
Last comment field example

Didit Metadata

Changes after updating metadata. The field is in text format and is empty until a user provides a value. If there is no metadata in the issue’s checklist, the field will remain blank.

Metadata field example
Metadata field example

If there are multiple metadata fields in the checklist, Didit will list them all in the “Didit metadata” custom field, separated by commas, with a colon after the field name.

Multiple metadata fields example
Multiple metadata fields example

Since this is a text field, the value will look something like:

Team member name: Timothy Jones, Training program name: Compliance training program, Version: 64

Checklist Completion Summary

This is a text field containing the checklist completeness as a fraction and percentage.

Completion summary field example
Completion summary field example

JQL for Checklist Fields

You can search for Jira issues that have a “Checklist completion percentage” of over or under a certain amount. This can be useful if you want to quickly see which Jira issues need your attention. You can also create a filter subscription to remind assignees of checklist tasks.

JQL for Checklist Fields
JQL for Checklist Fields

Boards

You can display the completion status of checklists on Jira boards in company-managed projects to get a better overview of checklist statuses. You can use any of the above fields in the “Card Layout” section of your board configuration.

Checklist status on boards
Checklist status on boards

General Field Behavior

  • If you replace the checklist with another one, the fields will reset to their default values.
  • The fields will not reset if a checklist is removed from an issue, only when a new checklist is added.
  • If there are multiple checklists attached to an issue, the fields will aggregate. For example, if there are two checklists with ten tasks each, the “Didit Checklist task completed

Notifications

Notifications related to updates in Didit custom fields are suppressed. However, you can still trigger automation rules based on these field updates.

Custom Fields Default Value and Type Summary

Custom FieldField TypeDefault Value
Didit tasks completed percentagenumber0
Didit checklist completedtextno
Didit skipped tasksnumber0
Didit last commenttextempty
Didit metadatatextempty
Checklist completion percentagenumber0
Checklist completion summaryread-only-

Link to this page: https://seibert.biz/diditcustomfields