Skip to main content

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.

SettingWhat it doesDefault
Field to showA user field of the related work item, such as Assignee or ReporterNone, so you pick one
If several are linkedThe user from the first linked item that has one. It's the only optionThe 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.

  1. Create the field from the Epic owner recipe, or open the configuration page of a Parent Field - User field.

  2. In Read from, select The nearest work item at a level, such as its epic, and in Level, select Epic.

  3. In Field to show, select Assignee (assignee).

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