Usage

Reverting a Page

Reverting requires the Editor role or higher. See Configuration for the full permissions table.

Reverting from the admin interface

  1. Open the page's history and click View on the version you want to restore.
  2. Scroll to Revert to this version.
  3. Optionally type a reason in Change note (optional) (up to 500 characters). HTML tags are stripped from the note.
  4. Click Revert to this version.

You are returned to the page's history with the message "Page successfully reverted to version #N."

What a revert does

  • The live page's title, slug, visibility, layout, layout data and blocks are replaced with the contents of the chosen version through Omeka's own API, exactly as if the page had been saved in the editor with that content. The page keeps its ID, its site and its URL.
  • Blocks are recreated from the snapshot, so they receive new block IDs.
  • A new version is stored with the operation revert, containing the restored content. Its note is your change note, or "Reverted to version #N (saved YYYY-MM-DD HH:MM:SS)" if you left the note empty.
  • The version you reverted to is left in place, so you can revert again later or compare it with the new entry.

The revert entry is the only version written during the operation. The state of the page just before the revert is not captured separately; it is already represented by the most recent version, provided the page was last saved while the module was active.

A revert counts towards the retention limit like any other version.

Reverting from a script

The JSON API can perform the same revert; see REST API.

When a revert fails

  • If the page has been deleted, the update cannot be applied and the message "Revert failed: ..." is shown. Versions of deleted pages can still be viewed and exported, but not restored.
  • If the form was left open long enough for the CSRF token to expire, the message "Invalid request (CSRF token mismatch or form error). Please try again." is shown. Reload the snapshot page and submit again.
  • Users below the Editor role do not see the revert form; a direct POST is refused with "You do not have permission to revert pages."
Log in for Support