> ## Documentation Index
> Fetch the complete documentation index at: https://docs.custral.com/llms.txt
> Use this file to discover all available pages before exploring further.

# History

> A record's status changes over time, with time-in-stage.

## 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](/blocks/embedded/object/timeline): all activity on the record, not just one property.
* [Property list](/blocks/embedded/object/property-list)


## Related topics

- [Data Import](/automation/jobs/migrations.md)
- [Fields](/data/records/fields.md)
- [Notes](/blocks/embedded/object/notes.md)
- [Workflows](/automation/workflows/overview.md)
- [Change Log](/product/updates.md)