Your team works to have recent and relevant information available to your customers. As a result, they regularly update and publish content. Versioning helps keep track of these updates made to the content items.
Versioning is useful to rollback content updates, such as when there is a mistake or to go back to a better version.
Create versions
You can enable versioning for content and assets from the Admin > Settings > General page.
When versioning is enabled, every edit or update you make to a content item or assets creates a version. Content stores multiple snapshots of content items and assets on your subscription. The original version with the associated metadata — tags and image renditions — is saved.
Note: The saved version of the original files and images is like creating a copy of the files. The amount of data storage used for the saved version is the same as a copy.
Versions are not created for attachments, links, or other referenced content items.
Preview and restore versions
Anyone who has access to the content item and assets can view and restore versions.
From the content form, you can click the History icon and view the list of versions created. The latest version is at the top of the list. The list provides a quick summary of the content item's status and the person who edited it.
To preview a version:
- With the content item open, click the History icon.
- Click on the version you would like to preview from the drop-down list.
- The content opens in the preview mode.
- You can switch back to the current version at any time. Click View current version to exit the preview mode and click Restore.
To restore a previous version:
- Hover over the version you would like to restore from the drop-down list.
- The restore button is visible.
- Click Restore. The content item restores as a draft.
For example, a published content item, when restored to an earlier version, becomes a draft.
Note: Any change to the name of a published object does not automatically change the name of the published resource in the Delivery URL. However, if you revert to an earlier version of the object, and the version you revert to contains the new name, the republished object Delivery URL will adopt the name change. This only happens when you revert to an older version of an object that also contains a different name value than the originally published object.
Note: If approvals are enabled when you restore a content item or asset, they will need to be approved again.
Tip: You can restore a deleted content item only through the APIs.
Understand when versions expire
The status of your content and assets affects how many versions and for how long they are saved.
- Published content and assets - you can save up to 5 versions for a year.
- Draft content and assets - you can save up to 30 versions for three months.