Skip to main content

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.

SettingWhat it doesDefault
Field to showA date or date-time field of the related work item, such as Due dateNone, so you pick one
If several are linkedThe latest or The earliest of the linked work items' datesThe 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.

  1. Create the field from the Epic due date recipe, or open the configuration page of a Parent Field - Date 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 Due date (duedate).

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