Parent Field - Date
A Parent Field - Date field shows a date from a related work item, such as the epic's due date on every story.
The value is a date, so you can search and sort by it with relative dates such as endOfMonth().
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 a date in your own date format.
If there's nothing to show, you see None. When you hover over it, you see why.
Lists, search and exports use the stored date.
Settingsβ
The settings are the same as for Parent Field, with two differences.
| Setting | What it does | Default |
|---|---|---|
| Field to show | A date or date-time field of the related work item, such as Due date | None, so you pick one |
| If several are linked | The latest or The earliest of the linked work items' dates | The latest |
A date-time field keeps only its day.
Save stays off until you pick a field and tick the app access box.
Example: the epic's due date on every storyβ
You want to plan and sort stories by the date their epic is due.
-
Create the field from the Epic due date recipe, or open the configuration page of a Parent Field - Date 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 Due date (duedate).
-
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 due on 30 June show that date. Work items outside an epic show None.
Search with JQLβ
JQL compares the stored date, like any date field.
To list the work whose epic is due this month, soonest first, use:
"Epic due date" <= endOfMonth() ORDER BY "Epic due date" ASC
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.
Relatedβ
-
Parent Field: all sources, levels and link options in full.
-
Countdown: count the working days left until a due date.
-
Acknowledge app access: let the field read other work items with the app's access.