docs.modx.pro
  1. Extras
  2. msBulkEditor
  3. Interface
  4. History and rollback

History and rollback ​

Log of bulk operations and restore of previous values.

History tab

History tab ​

ColumnContents
CheckboxOnly for status Completed (bulk rollback); otherwise disabled with hint “Rollback is available only for completed operations”
IDOperation identifier
TypefieldType
CreatedDate and time (compact, two lines)
Statusqueued, running, completed, failed, cancelled
Processedprocessed
Totaltotal

Row actions: Rollback, Changes.

Empty log: empty state “History is empty”. Load failure: empty state error.

Statuses ​

StatusRollback
Queued / RunningUnavailable
CompletedFull or selective
Failedapplied items only
CancelledUnavailable

Failed operation (failed) ​

  1. Open History — status Failed.
  2. Changes — roll back applied items.
  3. Fix the cause and rerun on remaining products.

Roll back entire operation ​

  1. Find a completed operation.
  2. Rollback → confirm.
  3. API products/rollback with operationId.
  4. Restores old values from msbe_operation_items.

Requires msbulkeditor_rollback.

Rollback confirmation

Bulk rollback ​

Select several completed operations → Rollback selected.

Bulk rollback confirmation

Detail and selective rollback ​

Changes opens the panel below the table (page scrolls to it).

  • item list (product × field);
  • preview table with checkboxes;
  • Rollback selected — productIds[].

Checkbox is active only for status applied. Other statuses show a disabled checkbox with a tooltip.

Click the operation ID in the panel to copy it to the clipboard (toast).

API: history/items, products/rollback.

Operation Changes panel

Record retention ​

  • Tables: msbe_operations, msbe_operation_items — see Events.
  • Auto cleanup: Scheduler task operation_cleanup when msbulkeditor_scheduler_enabled = Yes.
  • Retention: msbulkeditor_history_retention_days (default 90).

Notes ​

  • Snapshots are written for all field types with a value snapshot, not only price.
  • Side-effect ops (gallery regenerate, clear cache) roll back metadata per handler rules; files on disk are not always restored — see product and prices.

See also ​