Managing dashboard version history

This documentation topic is designed for Grafana workspaces that support Grafana version 10.x.

For Grafana workspaces that support Grafana version 9.x, see Working in Grafana version 9.

For Grafana workspaces that support Grafana version 8.x, see Working in Grafana version 8.

Whenever you save a version of your dashboard, a copy of that version is saved so that previous versions of your dashboard are not lost. A list of these versions is available by entering the dashboard settings and then selecting Versions in the left side menu.

Note

The most recent 20 versions of a dashboard are saved.

The dashboard version history feature lets you compare and restore to previously saved dashboard versions.

Comparing two dashboard versions

To compare two dashboard versions, select the two versions from the list that you wish to compare. Click Compare versions to view the diff between the two versions. This brings up the version diff view. By default, you’ll see a textual summary of the changes.

If you want to view the diff of the raw JSON that represents your dashboard, you can do that by clicking the View JSON Diff button at the bottom.

Restoring to a previously saved dashboard version

If you need to restore to a previously saved dashboard version, you can either select the Restore button on the right of a row in the dashboard version list, or select the Restore to version <x> button in the diff view. Selecting either of these will prompt you to confirm the restoration.

After restoring to a previous version, a new version will be created containing the same exact data as the previous version, only with a different version number. This is indicated in the Notes column for the row in the new dashboard version. This ensures your previous dashboard versions are not affected by the change.