> 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/settings.md).

# Settings

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

The change log records the changes of a project: the properties of P\&ID and 3D piping objects, the properties of the drawings and of the project, and the life of a drawing - created, renamed, moved, removed, new versions and revisions. This page sets what is recorded, when, and where the history is shown.

To open it, start Plant Project Setup from the PlantExpressTools ribbon or from PlantProjectManager and select **PlantTools Settings → PlantExpressTools → Change Logging**.

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

The settings belong to the project: they are stored in the project's PlantTools.zip and apply to everyone who works on it. In a Collaboration or Vault project, PlantTools.zip is checked out while the page is open and checked in again after **OK** or **Apply**.

The page has two halves: **Record changes** decides what is written to the change log, **Show changes** decides where the recorded history is shown. Each has a main switch of its own, so a project can keep recording without showing anything, or keep showing an existing history without recording more.

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

What is written to the change log, and when. With **Change logging** off, the options below are greyed out and keep their values.

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

The main switch: **ON** records the changes of this project, **OFF** writes nothing new to the change log. The history recorded so far is kept, and whether it is shown is set under **Show changes**.

### <mark style="color:blue;">Saving the drawing</mark>

The first of the occasions under **Save log when ...**: the changes of a drawing are written to the change log each time the drawing is saved. At least one occasion must be ticked - otherwise nothing is ever recorded.

### <mark style="color:blue;">Closing and saving the drawing</mark>

The changes are written when the drawing is saved as it is closed. Use it instead of **Saving the drawing** to record once per editing session rather than on every save.

### <mark style="color:blue;">Creating a version</mark>

The changes of a drawing are written before PlantProjectManager creates a version of it, so the new version starts with a complete history. With several drawings selected, they are recorded one after another.

### <mark style="color:blue;">Creating a revision</mark>

As **Creating a version**, for a revision.

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

Enables **Store changes in Change Log** in the context menu of a P\&ID drawing in PlantProjectManager, which writes the drawing's changes at any time - see [Update the Change Log manually](https://help.auxalia.com/plant-tools/plantexpresstools/how-to-use/plantprojectmanager/usage/pid-3d-drawing-node/store-changes-in-change-log.md). The drawing is saved with it, so AutoCAD's UNDO cannot go back past that point.

### <mark style="color:blue;">Changes by automated tools</mark>

Under **Also log ...**: a value changed by a calculation or by PlantLink's link mapping is recorded with the tool's name - 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). Unticked, such a change is recorded with the next save like your own, without the tool's name.

### <mark style="color:blue;">Drawing and project properties</mark>

Records the changes of drawing and project properties made in PlantProjectManager, and the life of a drawing - created, renamed, moved, removed, new versions and revisions. They are shown on the **Change Log** tab of PlantProjectManager - see [Track drawing and project properties](https://help.auxalia.com/plant-tools/planttools/change-log/workflows/track-drawing-and-project-properties.md) and [Follow the life of a drawing](https://help.auxalia.com/plant-tools/planttools/change-log/workflows/follow-the-life-of-a-drawing.md).

### <mark style="color:blue;">Drawing opened / closed</mark>

Records each time a drawing is opened or closed, with the user. Off by default, because it adds many entries.

### <mark style="color:blue;">Read-only properties</mark>

Records the changes of read-only properties too. Read-only properties often have fixed values or are filled by calculations, PlantLink or PlantSpecDriven, so their history may not be of interest - untick it to keep them out of the change log.

### <mark style="color:blue;">Maximum age (days)</mark>

Under **Keep history**, together with **Maximum entries per property**: entries older than this number of days are removed from a drawing's change log each time something new is written to it. **0** keeps all entries.

**Maximum entries per property**: only this number of the newest entries of each property is kept. **0** keeps all of them.

Both keep the change log files small in a long-running project; what has been removed cannot be restored.

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

Where the recorded history is shown. With **Show change history** off, the options below are greyed out and keep their values.

### <mark style="color:blue;">Show change history</mark>

The main switch of the display: **ON** shows the history where the options below say. A history recorded earlier stays readable when **Change logging** is switched off.

### <mark style="color:blue;">Change log tab (PlantProjectManager)</mark>

Shows the **Change Log** tab in PlantProjectManager's side panel, with the history of the selected project or drawing - see [PlantProjectManager Change Log Tab](https://help.auxalia.com/plant-tools/planttools/change-log/reference/plantprojectmanager-change-log-tab.md).

### <mark style="color:blue;">History icons (PlantProjectManager)</mark>

Shows the history icon behind a drawing or project property on the **Properties** tab of PlantProjectManager. A click on it opens the history of that property.

### <mark style="color:blue;">History tab (Properties Palette)</mark>

Shows the **History** tab in the Properties Palette of PlantExpressTools and PlantDataManager: when and by whom the selected object was created and last changed - see [History Tab](https://help.auxalia.com/plant-tools/planttools/change-log/reference/history-tab.md).

### <mark style="color:blue;">History toggle button (Properties Palette)</mark>

Shows the history button at the top of the Properties Palette. **Green**: the history icons are shown behind the properties; **grey**: they are hidden. Hiding them does not stop the recording.

### <mark style="color:blue;">History icon (Properties Palette)</mark>

Shows the history icon behind a property that has a recorded history. A click on it opens the list of its earlier values - see [Property History](https://help.auxalia.com/plant-tools/planttools/change-log/reference/property-history.md).

### <mark style="color:blue;">History icons in the data grid (PlantDataManager)</mark>

Shows the history icons in the cells of PlantDataManager's data grids too, not only in its Properties Palette - see [Find changes in PlantDataManager](https://help.auxalia.com/plant-tools/planttools/change-log/workflows/find-changes-in-plantdatamanager.md).

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

**Newest first** shows the latest change at the top of every history list, **Oldest first** the earliest. The versions and revisions of the drawing are listed between the entries in the same order.
