> For the complete documentation index, see [llms.txt](https://help.auxalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.auxalia.com/plant-tools/planttools/change-log/reference/property-history.md).

# Property History

{% hint style="danger" %}
**Not released yet.** This page describes a function of an upcoming release.
{% endhint %}

A property with a recorded history carries a history icon at the right of its value. A click on it opens the list of the property's earlier values. The icon and the list are shown in the Properties Palette of PlantExpressTools and PlantDataManager, in PlantDataManager's data grids and - for drawing and project properties - on the **Properties** tab of PlantProjectManager. [Settings](https://help.auxalia.com/plant-tools/planttools/change-log/settings.md) decides where they appear.

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-2a5dbb48da9656141fcb8e1f2dc3291c64a8763f%2FCL-property-history-0001.png?alt=media)

## <mark style="color:blue;">History icon</mark>

**Green**: the value is the one recorded last. **Orange**: the value has been changed since and is recorded with the next save - a value changed in PlantDataManager stays orange until the change is imported into the drawing with the PlantDataManager plug-in. **Grey**: an acquired property that is read-only; its history can be viewed, but not restored. A property without an icon has no recorded change yet; with several objects selected, no icons are shown. The tooltip is **Show Change History**.

## <mark style="color:blue;">Search</mark>

Type a text into the field above the list and click **Find**: the list keeps only the rows that contain it.

## <mark style="color:blue;">Version</mark>

A row with a version (`V 1`) or a revision (`R A`) marks when PlantProjectManager created that version or revision of the drawing; the changes are listed between these rows.

## <mark style="color:blue;">Acquisition Mode</mark>

For an acquired property: the acquisition mode the value had.

## <mark style="color:blue;">Value</mark>

The value the property had from that change on.

## <mark style="color:blue;">Date & Time</mark>

When the change was recorded.

## <mark style="color:blue;">User</mark>

Who made the change - for a change from the PlantDataManager import, the user who made it in PlantDataManager.

## <mark style="color:blue;">Source</mark>

The tool and the occasion of the change, e.g. `PET - OnDrawingSave` for a change recorded with a save, or the name of a calculation - see [See who or which tool changed a value](https://help.auxalia.com/plant-tools/planttools/change-log/workflows/see-who-changed-a-value.md).

## <mark style="color:blue;">Restore to this value</mark>

In the Properties Palette - and in a data grid of PlantDataManager - right-click a value and choose **Restore to this value**: the value is written back into the object, the icon turns orange, and the next save records it as a new change. Restoring does not go back in the history: the later entries stay. For an acquired property a message asks first, because the acquisition mode changes with the value - see [Restore an earlier value](https://help.auxalia.com/plant-tools/planttools/change-log/workflows/restore-an-earlier-value.md).

![](https://2994090777-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZH2AGHzvPfBW7YdaaGc0%2Fuploads%2Fgit-blob-15796adea915ad89dcb759e31cf01d0fc01c72c6%2FCL-property-history-0002.png?alt=media)

## <mark style="color:blue;">Order</mark>

The newest change is at the top unless **Sort order** in [Settings](https://help.auxalia.com/plant-tools/planttools/change-log/settings.md) says **Oldest first**.
