These are the docs for the Metabase master branch. Some features documented here may not yet be available in the latest release. Check out the docs for the latest version, Metabase v0.49.

History

For questions, dashboards, and models, Metabase keeps a version history for the previous fifteen versions of that item. You can view changes, and revert to previous versions.

You can also archive, unarchive, and permanently delete outdated items.

Viewing tracked changes

  1. Go to your question, dashboard, or model.
  2. Click the info icon.
  3. A sidebar will pop up with a history of up to 15 versions.

Metabase will keep track of a version each time you save, move, revert, archive, or verify an item.

Reverting to previous versions

  1. Go to your question, dashboard, or model.
  2. Click the info icon (an i in a circle).
  3. A sidebar will appear with up to fifteen previous versions.
  4. Click on the back arrow beside a version to revert your item to that point in time.

Archiving items

Sometimes your questions, dashboards, or models outlive their usefulness. You can send outdated items to the Archive from the three dot menu ... of your questions, dashboards, or models.

Note that archiving an item will affect any dashboards, subscriptions, or SQL questions that depend on that item, so be careful!

Archiving multiple items

You can batch archive multiple items from the same collection:

  1. Go to the collection.
  2. Hover over the icon beside the name of the item.
  3. Click the checkbox that appears.
  4. When you’re done selecting your items, click Archive at the bottom of the page.

Archiving a collection

  1. Go to the collection.
  2. Click ... > Archive.

Archiving a collection archives all of the collection’s contents as well. You can only archive a collection if you have permission to Curate a collection (as well as all of the collections inside that collection). If you don’t see the Archive option, see your Metabase admin about your collection permissions.

Viewing the archive

  1. Open the main Metabase sidebar.
  2. Click the ... beside the “Collections” header in the sidebar.
  3. Click View archive.

To view archived events and timelines, go to the relevant unarchived collection, click on the collection’s Calendar icon, then the three-dot menu () and select the option to view the archived events or timelines.

Unarchiving items

  1. Open the main Metabase sidebar.
  2. Click the ... beside the “Collections” header in the sidebar.
  3. Click View archive.
  4. Hover over the item and click the unarchive icon (rectangle with a ^ symbol).

The unarchived item should get restored to the parent collection that it was most recently saved in. If you unarchive an item, but you don’t know where it’s reappeared:

  • search for the item directly, or
  • check if the item’s parent collection is also in the archive.

Unarchiving multiple items

You can unarchive multiple items at once from the same collection:

  1. Go to the collection.
  2. Hover over the icon beside the name of the item and click the checkbox that appears.
  3. When you’re done selecting your items, click Unarchive at the bottom of the page.

Deleting items permanently

  1. Open the main Metabase sidebar.
  2. Click the ... beside the “Collections” header in the sidebar.
  3. Click View archive.
  4. Hover over the item and click the trash bin icon.

The item will get permanently deleted from your application database.

Remember that archiving and deleting items can have unanticipated ripple effects on related dashboards, subscriptions, and SQL questions.

We recommend archiving because you can always unarchive if something breaks. If you delete an item and accidentally break something, you might have to recreate all of that work from scratch (unless you’re prepared to revert to a backup of your application database).

Deleting multiple items permanently

You can delete multiple items at once from the same collection:

  1. Go to the collection.
  2. Hover over the icon beside the name of the item and click the checkbox that appears.
  3. When you’re done selecting your items, click Delete at the bottom of the page.

Read docs for other versions of Metabase.

Thanks for your feedback!

See something that needs fixing? Propose a change.