Skip to main content
Skip table of contents

Issue Entity Properties

Saving data to entity properties can unveil checklist data to users who can view the issue, but do not have permission to view the checklist.

Entity properties will reflect the collective state of all checklists, Local and Global, on the issue.

Available properties

Issue Checklist sets the issue entity property checklist JSON object with the following fields/properties inside:

CODE
{
  "completedText": "Not Completed", // can also be "Mandatory Completed" or "All Completed"
  "activeItems": 2, // also aliased as "uncheckedItems"
  "allItems": 4,
  "uncheckedMandatoryItems": 1,
  "allMandatoryItems": 2,
  "hasActiveItems": true, // also aliased as "hasUncheckedItems"
  "hasItems": true,
  "allItemsCompleted": false,
  "hasUncheckedMandatoryItems": true,
  "hasMandatoryItems": true,
  "mandatoryItemsCompleted": false,
  "progressText": "Checklist: 2/4",
  "progressPercent": 50,
  "items": Item 1 Item 2 Item 3 Item 4
}

Example usage

Entity properties are read-only.  Changes made directly to the entity properties will not update the checklist and will be overwritten by changes made in the checklist UI (or in any other valid way such as through the API, Checklist Text field, automation, a post function, etc.).

Entity properties can be used in:

  • Automation
    In Automation rules, issue entity properties can be accessed through the smart values feature, e.g. 

CODE
{{issue.properties.checklist.progressText}}

Get Entity Properties

You can get an issue’s entity properties in the following ways:

Jira API REST Request

Open terminal (command-line interface) and execute the following curl command, replacing:

  • your-domain with your Jira URL

  • {issueKey} with valid Jira issue key

  • email@example.com with your email

  • api_token with your API token

CODE
curl --request GET \
  --url 'https://your-domain.atlassian.net/rest/api/2/issue/{issueKey}?properties=*all' \
  --user 'email@example.com:<api_token>' \
  --header 'Accept: application/json'

You can also make the request through a third-party tool such as Postman.

Entity Property Tool App

  1. Install the Entity Property Tool app.

  2. Open the issue page.

  3. Select the Entity properties tab to see the details of the entity properties.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.