Menu

This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

DocumentationGrafana documentationDashboardsBuild dashboardsManage version history
Grafana Cloud Enterprise Open source

Manage dashboard version history

Whenever you save a version of your dashboard, a copy of that version is saved so that previous versions of your dashboard are never lost. You can see a list of dashboard versions in the Versions tab of the dashboard settings:

Dashboards versions list

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

Compare two dashboard versions

To compare two dashboard versions, follow these steps:

  1. Click Edit in the top-right corner of the dashboard.
  2. Click Settings.
  3. Go to the Versions tab.
  4. Select the two dashboard versions that you want to compare.
  5. Click Compare versions to view the diff between the two versions.
  6. Review the text descriptions of the differences between the versions.
  7. (Optional) Expand the View JSON Diff section of the page to see the diff of the raw JSON that represents your dashboard.
  8. When you’ve finished comparing versions, click Back to dashboard and Exit edit.

When you’re comparing versions, if one of the versions you’ve selected is the latest version, a button to restore the previous version is also displayed, so you can restore a version from the compare view:

Dashboards versions diff

Restore a previously dashboard version

To restore to a previously saved dashboard version, follow these steps:

  1. Click Edit in the top-right corner of the dashboard.
  2. Click Settings.
  3. Go to the Versions tab.
  4. Click the Restore button next to the version.

When you restore a version, the dashboard is immediately saved and you’re no longer in edit mode.

After you restore a previous version, a new version of the dashboard is created containing the same exact data as the previous version, but with a different version number. This is indicated in the Notes column in the Versions tab of the dashboard settings. This is done simply to ensure your previous dashboard versions are not affected by the change.