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β
| Setting | What it does | Default |
|---|---|---|
| Jira Expression: | The expression that FieldCraft runs for each work item | None, so you write one |
| Round to | As returned, Whole number, 1 decimal, 2 decimals or 3 decimals | As returned |
| Show after the number (optional) | A unit of up to 12 characters, such as %, pts or h | None |
| Display | A plain number, a traffic light or a progress bar | Plain 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.
-
Open the configuration page of a Jira Expressions - Number field named WSJF.
-
Select Snippets, and copy the WSJF score snippet into Jira Expression:.
-
Replace the four field IDs with your own fields' IDs.
-
In Round to, select 1 decimal.
-
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
| Placeholder | Description |
|---|---|
customfield_1 to customfield_3 | Your business value, time criticality and risk reduction fields |
customfield_4 | Your 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.
Relatedβ
-
Write a Jira expression: use the editor, snippets and the check before you save.
-
Show a traffic light or progress bar: color the value by thresholds.
-
Rollup: total a number over the children without an expression.