Previous Value
A Previous Value field shows, as text, the value a field you choose had before its last change, or its first value.
What you seeβ
On the work item and in lists, you see the earlier value as text, such as Alice Smith or In Review.
For a person, you see the display name. For a select field, you see the option's name, and for a date, 2026-12-20.
When there's no earlier value yet, the field shows None. The hover tells you what it waits for.
You search and sort by the stored text.
Settingsβ
| Setting | What it does | Default |
|---|---|---|
| Field | The field whose history you read. You must pick one | None |
| Show | Previous value or First value | Previous value |
| Show the exact value before the last change, even if it was empty (when off, the last real value is shown) | Shown with Previous value. Shows an empty earlier value as empty | Off |
In Field, you can pick only fields that Jira keeps a change history for. Attachments, linked work items and other FieldCraft fields don't appear.
Previous and first valuesβ
Previous value shows the last value before the current one that wasn't empty. With the checkbox on, it shows exactly the value before the last change, even when that was empty.
First value shows the oldest value that wasn't empty. For a field that never changed, that's its current value.
For Components, Fix versions and Affects versions, the field shows the whole earlier list.
Example: the previous assigneeβ
You want to see who had each work item before the current assignee.
-
Create the field from the Previous assignee recipe, or open the configuration page of a Previous Value field.
-
In Field, select Assignee (assignee).
-
In Show, keep Previous value.
-
Select Save.
Result: When a story moves from Alice Smith to Sam Lee, the field shows Alice Smith.
Search with JQLβ
The value is text, so JQL matches it exactly with = or !=. The ~ operator finds nothing.
To find work items that Alice Smith had before, use:
"Previous assignee" = "Alice Smith"
You can also use the field ID, for example cf[10151] = "Alice Smith".
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β
-
The value is text, not a person. Search by the display name.
currentUser()doesn't work here. -
The field keeps the name from the time of the change. If someone renames a person or an option later, the old name stays.
-
Values longer than 255 characters end with
β¦. -
In Jira's list of field types, this type is FieldCraft: Previous Value.
Relatedβ
-
Field Change Count: count how many times a field changed.
-
Modified By: see who made the first or last change.
-
First/Last Field Change Time: see when a field first or last changed.
-
Search and report with FieldCraft fields: use the value in filters, boards and dashboards.