History - Custral Docs

Overview

The History block shows how a record has moved through the values of a status or select property. Each change, when it happened, and how long the record spent in each stage. It reads the change log for one property on the open record, so a Deal’s page can show its pipeline path (Lead → Qualified → Won) with the days spent at each step.

Use cases

A Deal record: see the pipeline path and where it stalled (time-in-stage).
A Ticket or Case: audit the status trail (Open → Pending → Resolved).
Any record where “how did this get here, and how long did it take?” matters.

Configuration parameters

Param	Type	Description
`objectId`	`object`	The object the block is bound to. Set automatically when placed on a record page.
`propertyId`	`field`	The select or status property whose change history is shown (required).

Troubleshooting

Symptom	Likely cause	What to check
The block is empty	The record has never changed the chosen property	Expected until the property is edited at least once.
No property to pick	The object has no select / status property	Add a select or status property to the object first.
Time-in-stage looks off	Changes were imported/backfilled without timestamps	Only in-app changes carry an exact time; imported history may be approximate.

See also

Timeline: all activity on the record, not just one property.
Property list