How to view and restore a previous version of an asset

Summary

With Asset Versioning you can browse an asset’s history, compare previous versions, and restore an older version when needed. Restoring a version creates a new version that contains the values from the selected previous version.

Example use case: Correct accidental changes

You notice that several attributes of an asset were accidentally changed (wrong label, missing media, etc.). Instead of manually re-entering values, you can open the asset’s history, inspect previous versions, and restore a version that contains the correct values.

How to access asset History

  1. Go to Assets.
  2. Open the asset you want to inspect.
  3. Click the History button in the top right-hand corner.

Viewing a version

In the history modal:

  • Versions are listed with the newest first.
  • Each version is displayed as: V{version_number} - {version_creation_date} - {user} (for example: V3 - 2025-11-12 10:42 - John Doe).
  • Select a version to view a snapshot of the asset at that point in time. Changes from the previous version are highlighted so you can quickly spot what changed.
  • You can view changes made to scopable/localizable attributes by selecting a different channel and/or locale via the scope selector.

 

Notes

  • Only versions from the last 30 days can be viewed.
  • Only the last 20 versions of an asset can be viewed
  • If a version was created by an automated process, the user field will show System.
  • If an asset has been deleted, its versions are no longer accessible.

Restoring a version (only for Advanced and Premium editions)

  1. While viewing the chosen version, click the Restore button in the top right-hand corner.
  2. A confirmation modal appears explaining that restoring will create a new version with the values from the selected version.
  3. Confirm the action. A new version is created; the asset now contains the values from the restored version and can be edited or published as usual.

Important:

  • Restoring a version does not overwrite the version history. Instead it generates a brand new version (e.g., if you restore V3 while the latest is V6, a new V7 is created reflecting V3’s values).
  • Restoring a version does not modify the current asset family structure. If the restored version has value on deleted attributes, they will be not restored, event if a new attribute with the same code was created.
  • The newest version cannot be restored

Access Control

To ensure data governance, access to asset versioning features depends on Asset Manager permissions:

  • To view versions, users must have the "View asset versions" permission
  • To restore versions, users must have the "Restore asset versions" permission and the existing "Edit the assets" permission.

Without the required permissions, the history modal and/or restore option will not be available.