Skip to main content

Jira expressions

The Jira expression field types store the result of your own Jira expression, for when no other field type fits.

You write the expression once.

FieldCraft runs it for each work item and stores the result, so you can search and sort by it.

Field types in this section​

Pick the type by what the expression returns and how you want to search it.

Field typeStoresUse it for
Jira Expressions - TextTextLabels and short summaries, such as 3/5 done. JQL matches text only exactly
Jira Expressions - NumberA numberScores and counts, with rounding, a unit and a traffic light or progress bar
Jira Expressions - DateA dateA day, such as the latest due date among the sub-tasks
Jira Expressions - Date & timeA date and timeA moment, such as when the last comment was added
Jira Expressions - UserA userA person, searchable with currentUser()

To write, check and save an expression, see Write a Jira expression.

When another type fits better​

Built-in types follow their data more closely than an expression does.

  • To show a field of the parent or the epic, use the Parent Field types. They update when the parent changes.

  • To total the children, use Rollup.

  • To count down to a date, use Countdown. It stays current on its own.

Calculated with the app's access​

FieldCraft runs the expression with the app's access. It can read work items and comments that the person viewing the field can't see.

Everyone who can see the work item sees the stored value.

A Jira admin acknowledges this once per field before it calculates. See Acknowledge app access.

When the value updates​

FieldCraft runs the expression again when the work item changes a field that the expression reads.

If it can't tell what the expression reads, every change counts.

On a parent, the expression runs again when you add, remove or move a child. If it reads .subtasks or .stories, a child's status change counts too.

For children, you need Update parents and children turned on in the Settings tab.

Changes to the parent or to linked work items don't reach the field. It catches up when the work item changes or when you open it.

When you open the work item, FieldCraft runs the expression again, at most every 15 minutes.

Expressions never refresh hourly.

See How values stay current.