Exporting and Deleting Versions

Exporting a version as JSON#

Any user who can view history can export. Click Export in a history list, or Download as JSON on a snapshot page, or open /admin/page-versioning/export/{versionId}.

The download is named page-version-{id}-{YYYYMMDD-HHMMSS}.json and contains the whole version row with the payload decoded:

{
  "id": 99,
  "resource_id": 42,
  "resource_type": "site_page",
  "title": "About the collection",
  "slug": "about",
  "payload": {
    "id": 42,
    "title": "About the collection",
    "slug": "about",
    "is_public": true,
    "layout": null,
    "layout_data": [],
    "blocks": [
      {
        "layout": "html",
        "data": { "html": "<p>Welcome to the archive.</p>" },
        "layout_data": [],
        "position": 1
      }
    ],
    "site_id": 1
  },
  "operation": "update",
  "editor_id": 3,
  "editor_name": "Jane Doe",
  "summary": null,
  "created_at": "2026-03-15 14:30:00"
}

Exports are a convenient way to keep a copy of important versions before uninstalling the module or lowering the retention limit. There is no import; a snapshot is restored with a revert, not by uploading a file.

Deleting a single version#

Deleting requires the Editor role or higher.

1. In a history list, click the delete icon at the end of the row, or click Delete this version on a snapshot page.
2. A confirmation sidebar opens showing the version's page title, save time, editor and operation, with the warning "This cannot be undone."
3. Click Confirm delete.

The version row is removed permanently and you are returned to the page's history with the message "Version #N has been deleted." The live page is not affected.

Automatic deletion#

The retention limit deletes the oldest versions of a page automatically once it has more than the configured number. See Configuration.

Uninstalling#

Uninstalling the module drops the page_versions table and every version in it. See Installation.