# Asset History

## Installation

To install this app please follow the instructions as directed in the [Custom Apps instructions](/tools/general-apps.md).

## Usage

Start by choosing the asset you want to view the history of.

<figure><img src="/files/9mPPhkNkOEdM3SFRj0KT" alt=""><figcaption></figcaption></figure>

### Loading History

Clicking the Load History button will load and display the most recent 20 commits. These commits have been created each time an asset was modified through the Save or Autosave button in the platform to save the edits.

The history will be displayed in the order of the most recent commit to the oldest.

Each commit will show a set of important details:

* A checkbox to select the commit for a restore action
* A colored circle to indicate the commit belongs to a branch of other commits that share the same color. The earliest commit in a branch will also have a message indicating the commit ID of the restore point used to initiate that branch.
* The date and time the commit was created
* The commit ID
* The author of the commit
* A set of basic changes made in the commit, listing the objects that were affected

### Restoring to a Commit

Clicking the Restore button will restore the asset to the selected commit.

This will restore the asset to the state it was in at the time of the selected commit.

Performing a restore will set the Head Commit to be the commit that was chosen as the restore point, and will give the opportunity to start a new branch of changes.

{% hint style="warning" %}
**Any commits after the restored commit will be retained and marked as grey when the history is reloaded. These can be restored back at any time. They greyed out state simply helps to indicate which commit represents the current state of the asset.**
{% endhint %}

### Commit Branches

Making new saves to the asset after a restore will create new commits, which will start a new branch of changes. Every new branch will be marked with a different circle color in the history.

The new saves after a restore point will also move the current state of the asset back to the top of the history, to the most recent commit.&#x20;

<figure><img src="/files/cRiFxGjb6NjYQ7WTjt15" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://community.threekit.com/tools/general-apps/asset-history.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.