# Dashboard History

We’ve introduced **Dashboard History** for manual dashboards, available on both **Global Dashboards** and **Device Dashboards**. This feature allows you to track, review, and restore changes made to your dashboards over time.<br>

{% hint style="warning" %}
Dashboard history is *only* available for manually created dashboards. This means pre-configured dashboards, such as the Climate Monitoring Dashboard, will not have this feature available.
{% endhint %}

### Overview

With history, every change to a dashboard is recorded, giving you full visibility into its changes over time. This includes actions such as:

* Adding or duplicating widgets
* Editing widget content or layout
* Creating or modifying tabs
* Restoring previous versions

Each change creates a new entry in the dashboard history.

### Accessing the Audit Log

While in **Edit Mode**, click the **“History”** button in the top toolbar to open the dashboard history panel.

From there, you can:

* View a chronological list of all changes
* See who made the change and when
* Review optional change descriptions
* Restore any previous version of the dashboard<br>

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

### Change Descriptions

When saving a dashboard, you have the option to add a **change description**.

* This helps document what was modified (e.g. *“Added second widget”*)
* If left empty, a default message like *“Dashboard updated”* will be used<br>

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

### Restoring Previous Versions

You can restore any previous state of the dashboard with a single click.

* Click **“Restore”** on any history entry
* The dashboard will revert to that version
* The restore action itself is also logged as a new history entry

This makes it easy to undo mistakes or roll back changes.<br>

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

### Behaviour Across Dashboard Types

The history functionality works consistently across:

* **Global Dashboards**
* **Device Dashboards**

All changes are tracked using the same logic, regardless of dashboard type.

### Key Benefits

* **Full transparency** of dashboard changes
* **Version control** without manual backups
* **Easy rollback** to previous states
* **Improved collaboration** across teams


---

# 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://docs.datacake.de/dashboards/dashboard-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.
