Content History#

Content History stores previous document versions so editors can compare and restore earlier states from the Content Manager. This documentation explains how to browse and restore workflows for quick rollback of mistakes. Versions are only created for content edited in the Content Manager, and are kept for a maximum of 90 days.

The Content History feature, in the Content Manager, gives you the ability to browse and restore previous versions of documents created with the Content Manager.

CMS Growth or Enterprise plan None Available by default, if required plan Available in both Development & Production environment

A version is only created when a document is modified through the Content Manager in the admin panel. Content modified in any other way does not appear in the Content History of the document: this includes the REST API, the GraphQL API, the Document Service API, lifecycle hooks, cron jobs, and the strapi import and strapi transfer commands.

Configuration#

The only configurable aspect is how long versions are kept before they are deleted.

Content History is not a permanent archive. Versions are deleted automatically: a job runs once a day, at midnight, and deletes every version older than the retention period. Regardless of the plan, versions are kept for a maximum of 90 days, counted from the creation date of each version.

Versions deleted by the retention job cannot be recovered from the Content History interface.

Code-based configuration#

The retention period can be shortened, but never extended, with the history.retentionDays parameter of the /config/admin file. When both the license and the configuration file define a value, the lower of the 2 applies.

module.exports = ({ env }) => ({
  // … other configuration properties
  history: {
    retentionDays: 30,
  },
});

export default ({ env }) => ({
  // … other configuration properties
  history: {
    retentionDays: 30,
  },
});

There is no equivalent setting in the admin panel: the retention period can only be shortened from the /config/admin file.

Usage#

Path to use the feature: Content Manager
From the edit view of a content type: click (top right corner) then Content History.

Browsing Content History#

With Content History, you can browse your content through:

The main view on the left, which lists the fields and their content for the version selected in the sidebar on the right.
The sidebar on the right, which lists the total number of versions available, and for each version:
- the date and time when the version was created,
- the user who created it,
- and whether its status is Draft, Modified, or Published (see Draft & Publish for more information about document statuses).

Restoring a previous version#

You can choose to restore a previous version of a document. When restoring a version, the content of this version will override the content of the current draft version. The document switches to the Modified status and you will then be able to publish the content whenever you want (see Publishing a draft).

Browse the Content History and select a version via the sidebar on the right.
Click the Restore button.
In the Confirmation window, click Restore.