App Fields

App Fields are calculated by Dashlytics rather than stored directly in Jira. Dashlytics works them out from each work item's history and from the mappings in App Settings, so they can answer questions no single Jira field can — such as when a work item was actually completed.

Where App Fields Appear

App Fields can be selected in the field options of a Metric's configuration:

  • Time Grouping Field — decides which time period each work item falls into when a Time dimension is applied
  • Numeric Field — the field whose values a Metric such as Numeric Field Aggregation combines

In these dropdowns, fields are grouped into Jira Standard Fields, Custom Fields and App Fields. A dropdown only lists the App Fields that fit it: date fields in Time Grouping Field, number fields in Numeric Field.

List of App Fields

NameTypeAvailable inDepends on
Active DateDateTime Grouping FieldLifecycle Mapping
Completed DateDateTime Grouping FieldLifecycle Mapping
Closed DateDateTime Grouping FieldLifecycle Mapping
Dashlytics Story PointsNumberNumeric FieldStory Point Mapping

Active Date

The date and time a work item most recently moved into an Active status.

The value is empty if the work item has never been in an Active status, or if it has since moved out of one — for example, once it is completed. Grouping by Active Date therefore places only work items that are currently in progress.

Completed Date

The date and time a work item most recently moved into a Completed or Closed status. Closed statuses count as completed, so work that skips straight to Closed still has a Completed Date.

The value is empty if the work item has never been completed, or if it was reopened after its last completion.

Closed Date

The date and time a work item most recently moved into a Closed status.

The value is empty if the work item has never been closed, or if it was reopened after it was last closed.

Dashlytics Story Points

A single story points value for every work item, whichever kind of Jira space it belongs to. Company-managed and team-managed spaces store story points in different fields; Dashlytics Story Points reads the field chosen for each in Story Point Mapping.

The value is empty if the mapped field has no value for that work item.

Changing App Settings

Active Date, Completed Date and Closed Date follow the statuses assigned in Lifecycle Mapping, and Dashlytics Story Points follows Story Point Mapping. Changing either mapping changes these values in every report that uses them.

For AI agents: the complete documentation index is available at https://dashlytics-docs.vivek-fitkariwala.workers.dev/llms.txt, the full documentation bundle is available at https://dashlytics-docs.vivek-fitkariwala.workers.dev/llms-full.txt, and this page is available as Markdown at https://dashlytics-docs.vivek-fitkariwala.workers.dev/reference/app-fields/index.md.