Smart Values in Smart Panels

What you will learn here

On this page, you'll learn what Smart Values in Smart Panel are, how they work in JQL/ CQL, and how to use them.

Overview

The Smart Value in Smart Panel feature allows you to use dynamic values in your JQL (Jira Query Language), CQL (Confluence Query Language) queries instead of hardcoding static values. This makes your queries more flexible, reusable, and easier to maintain, since they automatically adapt to the context of the issue.

How The Smart Value Works

Smart Values in Smart Panel reference fields within an issue dynamically.
The syntax is:

CODE

smartValue(<field path>)

<field path> represents the JSON path of the issue field.
At runtime, this will be replaced with the actual field value from the issue.

The data you can access with these Smart Values comes directly from the Jira Issue API:
GET /rest/api/3/issue/{issueIdOrKey}

This means any field returned by that API can be used in a Smart Value expression.

CODE

{
  "id": "10002",
  "key": "ED-1",
  "fields": {
    "priority": { "name": "High" },
    "issuetype": { "name": "Bug" },
    "project": { "key": "EX", "name": "Example" },
    "status": { "name": "Open" },
    "description": { "type": "doc", "content": [ ... ] },
    "comment": [ { "id": "10000", "body": { "type": "doc", "content": [ ... ] } } ],
    "worklog": [ { "timeSpent": "3h 20m" } ]
  }
}

Example

JQL with Smart Values (Dynamic)

CODE

priority = smartValue(issue.fields.priority.name) AND issuetype = smartValue(issue.fields.issuetype.name)

Here:

smartValue(issue.fields.priority.name) → Gets the priority of the current issue.
smartValue(issue.fields.issuetype.name) → Gets the issue type of the current issue.

This query automatically adapts to whichever issue it is applied to, without requiring manual edits.

For a ticket such as ATD-1 with priority set to High and issue type set to Bug, the JQL is:

CODE

priority = "High" AND issuetype = "Bug"

CQL with Smart Values (Dynamic)

CODE

type = page and creator = smartValue(issue.fields.assignee.accountId)

Here:

smartValue(issue.fields.assignee.accountId) → Gets the account Id assignee of the current issue.

This query automatically adapts to whichever issue it is applied to, without requiring manual edits.

For a ticket such as ATD-1 with assigne set to user have Id: “122-884-dd02-ddffs”, the CQL is:

CODE

type = page and creator = "122-884-dd02-ddffs"