Parent Field
A Parent Field shows a field of a related work item as text, such as the status of the epic on every story.
In Jira's field type list, you find it as FieldCraft: Parent Status/Assignee/Priority/Any other field.
To search by a person, a date or a number, you use Parent Field - User, Parent Field - Date or Parent Field - Number.
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 value of the related work item as text, such as In Progress or High.
With several linked work items, you see all their values, separated by commas.
If there's nothing to show, you see None.
When you hover over it, you see why, for example Empty when there's no parent, or when its Status field is empty.
Lists, search and exports use the stored text.
Settingsβ
| Setting | What it does | Default |
|---|---|---|
| Read from | The parent, The grandparent (two levels up), The nearest work item at a level, such as its epic, or Linked work items of one link type | The parent |
| Level | The hierarchy level to look for, such as Epic. Shown for a level | The first level, usually Epic |
| Link type and Direction | Which links count, for example This item is blocked by β¦ or Either way. Shown for linked work items | No link type, and Either way |
| If several are linked | For this type, List them all | List them all |
| Field to show | The field to read from the related work item. Any field works | Status |
The In short: line sums up your choice, for example The Status of the parent. Empty without one.
A level such as the epicβ
FieldCraft walks up until it finds a work item on the level you pick. It goes up to 4 work items.
The levels are Jira's hierarchy levels, so they work in team-managed spaces too.
Each step up uses a little of the hourly calculation budget.
Linked work itemsβ
FieldCraft reads up to 50 linked work items of the link type and direction you pick.
Example: the epic's status on every storyβ
You want to find stories that are still open while their epic is already done.
-
Create the field from the Parent status recipe, or open the configuration page of a Parent Field.
-
In Read from, keep The parent.
-
In Field to show, keep Status (status).
-
Select I understand, and the values may be shown to everyone who can see the work item, and select Save.
Result: A story under a finished epic shows Done. A story without a parent shows None.
Search with JQLβ
The value is text, so JQL matches it exactly with = or !=. A search with ~ finds nothing.
To find open stories whose epic is finished, use:
"Parent status" = "Done" AND statusCategory != Done
To find open work items with any blocker, use the Blocker status recipe and:
"Blocker status" IS NOT EMPTY AND statusCategory != Done
When the value updatesβ
FieldCraft recalculates the field when the work item moves to another parent or its links change.
When someone changes the field on the related work item, FieldCraft updates the work items below it or linked to it.
It updates up to 500 work items below it per change.
For this, you need Update parents and children turned on in the Settings tab. See FieldCraft settings.
When you open the work item, FieldCraft reads the related work item again. It does so at most every 15 minutes.
Things to knowβ
-
Until a Jira admin acknowledges app access, the field keeps its last value. The hover says
Not recalculated until a Jira admin reviews this field in FieldCraft. -
Everyone who can see the work item sees the value, even if they can't open the related work item.
-
FieldCraft doesn't merge equal values. Two blockers in Done show
Done, Done, which= "Done"doesn't find. -
To count open blockers instead, use Calculated Metrics with Linked work items of one link type.
Relatedβ
-
Acknowledge app access: let a field read other work items with the app's access.
-
Parent Field - User: show a person from the parent or the epic, searchable as a user.
-
Rollup: total the children on the parent instead.
-
Search and report with FieldCraft fields: use the value in filters and boards.