Skip to main content

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​

SettingWhat it doesDefault
FieldThe field whose history you read. You must pick oneNone
ShowPrevious value or First valuePrevious 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 emptyOff

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.

  1. Create the field from the Previous assignee recipe, or open the configuration page of a Previous Value field.

  2. In Field, select Assignee (assignee).

  3. In Show, keep Previous value.

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

See How values stay current.

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.