Field Change Count
A Field Change Count field counts how many times a field you choose changed on a work item, such as the due date.
To count status moves with from and to statuses, use Transition Count instead.
What you seeβ
On the work item and in lists, you see a whole number, such as 3.
A field that never changed shows 0.
When you hover over the value, you see when it was last updated.
Search, sorting and CSV exports use the same number.
Settingsβ
| Setting | What it does | Default |
|---|---|---|
| Field | The field whose changes count. You must pick one | None |
| Don't count changes from an empty value (setting a value for the first time isn't counted) | Skips changes where the field had no value before | Off |
| Display | A plain number, a traffic light or a progress bar | Plain number |
One save that changes the field counts once.
Field lists only fields that Jira keeps a change history for. Fields such as Created, Updated, Comment and Watchers, and other FieldCraft fields, don't appear.
Example: count due date changesβ
You want to see how often the due date moved after someone first set it.
-
Create the field from the Due date changes recipe, or open the configuration page of a Field Change Count field.
-
In Field, select Due date (duedate).
-
Select Don't count changes from an empty value (setting a value for the first time isn't counted).
-
Select Save.
Result: A story whose due date you set once and then moved twice shows 2.
Search with JQLβ
JQL compares the stored number.
To find work items whose due date moved more than once, most changes first, use:
"Due date changes" > 1 ORDER BY "Due date changes" DESC
You can also use the field ID, for example cf[10149] > 1.
When the value updatesβ
FieldCraft recalculates the field when the work item changes.
Existing work items get a value when someone opens them, or when you recalculate existing work items.
Things to knowβ
-
Clearing a field counts as a change. With the checkbox on, setting it again afterwards doesn't count.
-
Until you save the configuration for the first time, the field stays empty.
-
In Jira's list of field types, this type is FieldCraft: Field Change Count.
Relatedβ
-
Transition Count: count status moves between the statuses you choose.
-
First/Last Field Change Time: see when a field first or last changed.
-
Previous Value: see the value a field had before its last change.
-
Show a traffic light or progress bar: color the value by thresholds.