Parent Field - User
A Parent Field - User field shows a person from a related work item, such as the epic's assignee on every story and sub-task.
The value is a user, so you can search it with currentUser().
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 person's avatar and name.
If there's nothing to show, you see None. When you hover over it, you see why.
Lists show the person's name. Search and exports use the stored user.
Settingsβ
The settings are the same as for Parent Field, with two differences.
| Setting | What it does | Default |
|---|---|---|
| Field to show | A user field of the related work item, such as Assignee or Reporter | None, so you pick one |
| If several are linked | The user from the first linked item that has one. It's the only option | The first linked item's |
Save stays off until you pick a field and tick the app access box.
Example: the epic's owner on every storyβ
You want people to find the work under the epics they own.
-
Create the field from the Epic owner recipe, or open the configuration page of a Parent Field - User field.
-
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 Assignee (assignee).
-
Select I understand, and the values may be shown to everyone who can see the work item, and select Save.
Result: Stories and sub-tasks under an epic show the epic's assignee. Work items outside an epic show None.
Search with JQLβ
JQL compares the stored user, like any person field.
To find the open work under the epics you own, use:
"Epic owner" = currentUser() AND statusCategory != Done
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.
-
Everyone who can see the work item sees the person, even if they can't open the related work item.
Relatedβ
-
Parent Field: all sources, levels and link options in full.
-
Parent Field - Date: show a date from the epic, such as its due date.
-
Acknowledge app access: let the field read other work items with the app's access.