Skip to main content

Jira Expressions - Number

A Jira Expressions - Number field stores the number that your Jira expression returns, such as a WSJF or RICE score.

You can sort, filter and chart by it, and color it with a traffic light or progress bar.

FieldCraft runs the expression with the app's access. A Jira admin must acknowledge app access first.

What you see​

On the work item, you see the number followed by the text you set, exactly as typed: % gives 67%. For 4.3 pts, type a space before pts.

If the expression returns nothing, you see None.

Lists show the same text. Search, sorting and exports use the stored number.

Settings​

SettingWhat it doesDefault
Jira Expression:The expression that FieldCraft runs for each work itemNone, so you write one
Round toAs returned, Whole number, 1 decimal, 2 decimals or 3 decimalsAs returned
Show after the number (optional)A unit of up to 12 characters, such as %, pts or hNone
DisplayA plain number, a traffic light or a progress barPlain number

The expression must return a number, or text that is a number, such as "3.5". Anything else leaves the field empty.

To count a list, add .length at the end.

Example: a WSJF score​

You keep four number fields for business value, time criticality, risk reduction and job size. You want a WSJF score on each feature.

  1. Open the configuration page of a Jira Expressions - Number field named WSJF.

  2. Select Snippets, and copy the WSJF score snippet into Jira Expression:.

  3. Replace the four field IDs with your own fields' IDs.

  4. In Round to, select 1 decimal.

  5. Select I understand, and the values may be shown to everyone who can see the work item, and select Save.

The snippet reads like this:

let size = issue.customfield_4 ?? 0;
size > 0
? ((issue.customfield_1 ?? 0) + (issue.customfield_2 ?? 0) + (issue.customfield_3 ?? 0)) / size
: null
PlaceholderDescription
customfield_1 to customfield_3Your business value, time criticality and risk reduction fields
customfield_4Your job size field

Result: A feature with values 8, 3 and 2 and a job size of 3 shows 4.3. Without a job size, it shows None.

Search with JQL​

JQL compares the stored number. To find the highest scores, use:

"WSJF" > 4 ORDER BY "WSJF" DESC

When the value updates​

FieldCraft runs the expression again when the work item changes or when you open it. See Jira expressions.

Things to know​

  • Until a Jira admin acknowledges app access, the field keeps its last value.

  • If the expression reads the current time, for example the Days since created snippet, the page shows a note. Search and lists then follow only when the work item changes or you open it.

  • For the working days left until a date, use Countdown. It stays current on its own.