Parent Field - Number
A Parent Field - Number field shows a number from a related work item, such as the epic's business value on every story.
With linked work items, it can show their sum, the smallest or the largest number.
It reads from the same sources as Parent Field: the parent, the grandparent, a level such as the epic, or linked work items.
FieldCraft reads the related work items with the app's access. A Jira admin must acknowledge app access first.
What you seeβ
On the work item, you see the number, or a traffic light or progress bar if you set one.
If there's nothing to show, you see None. When you hover over it, you see why.
Lists show the same format. Search, sorting and exports use the stored number.
Settingsβ
The settings are the same as for Parent Field, with three differences.
| Setting | What it does | Default |
|---|---|---|
| Field to show | A number field of the related work item, such as Story point estimate | None, so you pick one |
| If several are linked | Their sum, The smallest or The largest | Their sum |
| Display | A plain number, a traffic light or a progress bar | Plain number |
Save stays off until you pick a field and tick the app access box.
Example: the epic's business value on every storyβ
You keep a number field called Business value on epics. You want to sort stories by their epic's value.
-
Create a Parent Field - Number field in Jira settings, named
Epic business value, and open its configuration page. -
In Read from, select The nearest work item at a level, such as its epic, and in Level, select Epic.
-
In Field to show, select your Business value field.
-
Select I understand, and the values may be shown to everyone who can see the work item, and select Save.
Result: A story under an epic with a business value of 8 shows 8.
No recipe creates this type, so you set it up yourself.
Search with JQLβ
JQL compares the stored number.
To list stories of high-value epics, highest first, use:
"Epic business value" >= 8 ORDER BY "Epic business value" DESC
When the value updatesβ
The value follows the related work item, as described in Parent Field.
Things to knowβ
-
Until a Jira admin acknowledges app access, the field keeps its last value.
-
With linked work items, FieldCraft reads up to 50 of them.
-
To total the children of a work item instead, use Rollup.
Relatedβ
-
Parent Field: all sources, levels and link options in full.
-
Show a traffic light or progress bar: color the value by thresholds.
-
Acknowledge app access: let the field read other work items with the app's access.