Skip to main content

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​

SettingWhat it doesDefault
Read fromThe parent, The grandparent (two levels up), The nearest work item at a level, such as its epic, or Linked work items of one link typeThe parent
LevelThe hierarchy level to look for, such as Epic. Shown for a levelThe first level, usually Epic
Link type and DirectionWhich links count, for example This item is blocked by … or Either way. Shown for linked work itemsNo link type, and Either way
If several are linkedFor this type, List them allList them all
Field to showThe field to read from the related work item. Any field worksStatus

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.

  1. Create the field from the Parent status recipe, or open the configuration page of a Parent Field.

  2. In Read from, keep The parent.

  3. In Field to show, keep Status (status).

  4. 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.