Explore how AEM creates and maintains asset versions.


Asset versions visible via the timeline, provide a historical record of all changes made to an asset. Each version in composes the entirety of the asset including the original file, renditions an metadata. And automatically creates new versions when important actions occur such as when a file is re-uploaded and create version is selected.

We can see here that there’s now a new version, version 1.2 of this asset due to the re-upload. Likewise when metadata is edited, a new version is automatically created as well. Providing a historical record of the metadata’s changes.

Versions can also be made manually by selecting the asset and tapping create version. A meaningful label in description provide context as to what the version represents, and ensures it’s understandable to others. If no label or description is provided, a standard number versioning scheme is used. Clicking into an asset, and opening its timeline provides even more details and insights into its versions. Assets with image based representations can be previewed by selecting the version from the timeline, and clicking the preview version button. This opens a window which loads the selected version of that asset. Any version can be compared against the current version using the handy version comparison tool. Simply grab the handle in the right preview pane, and scrub back and forth to reveal the current assets representation underneath.

Versions can be reverted, meaning that versions assets state, including the original file, renditions and metadata can be reinstated as the current version of the asset. But remember, since there can only be one current version of an asset at a time, reverting to an earlier version changes the current version for all the users.

On this page