Asset Versioning

Asset versioning in Contentstack Assets provides a reliable way to track, manage, and recover changes made to assets over time. Every update to an asset, whether it is a binary file, its metadata, or even a Save Assets action, automatically creates a new version.

This ensures a complete, auditable history of changes throughout the asset lifecycle and supports collaboration, reduces risk, and helps teams maintain accuracy and consistency across campaigns, regions, and channels. Asset versions are accessible from the asset details view, where you can review, rename, or restore them as needed.

• Automatic Version Creation: Every asset update creates a new version automatically.
• Version History: Track the complete history of changes made to an asset.
• Version Navigation: Switch between versions using the version selector in the asset details view.
• Rollback and Recovery: Restore a previous version when an update needs to be reversed.

By default, Contentstack Assets assigns numeric version labels such as Version 1, Version 2, and so on. Assigning custom names helps identify the purpose or context of a specific version more easily.

To name or rename an asset version, perform the following steps:

1. Open Assets and navigate to the required asset.
2. Open the version selector in the top-right corner of the asset page.
3. Locate the version to rename.
4. Click the “Rename” icon next to the version.
5. Enter a meaningful name, such as Initial Banner Image or Approved for Campaign.
6. Confirm the change by selecting the checkmark icon or pressing enter/return.

Asset versioning allows you to restore a previous version when an update needs to be undone or reviewed.

To restore an asset version, perform the following steps:

1. Open Assets and navigate to the required asset.
2. Open the version selector in the asset details view.
3. Select the version to restore.
4. Review the asset file and metadata if required.
5. Click Save Asset to make the selected version the latest.

Once saved, the restored version becomes the latest version of the asset, while all previous versions remain available in the version history.

By using asset versioning effectively, teams retain full control over their digital assets while supporting fast, iterative content workflows across Contentstack.

Note Only users with edit permissions for assets can rename or restore asset versions. Users without edit access can view version history but cannot modify it.