Order Cleanup — Safely Delete Orders for Magento 2

What you get

Panth Order Cleanup — Safely Delete Orders from Magento 2

Permanently delete test orders, junk data, and unwanted transactions from your Magento 2 admin — with double verification, configurable safety controls, mass delete support, and a complete audit trail. Built for store owners who need a clean order history without the risk.

Magento 2 doesn't allow deleting orders out of the box. Panth Order Cleanup adds this missing functionality with industry-leading safety measures: a configurable delete button on every order view page, a mass delete action in the order grid, double confirmation with order ID verification (like GitHub's repo delete), per-status restrictions, and a detailed deletion log that records every deletion with admin user, IP address, timestamp, and a full snapshot of the deleted order data.

Preview

Mass Delete from Order Grid

Select multiple orders and choose "Delete Orders (Permanent)" from the mass actions dropdown.

Delete Button on Order View

A configurable "Delete This Order" button appears on every order detail page.

Double Confirmation Modal

Type the order number to confirm — prevents accidental deletions, inspired by GitHub's repository delete flow.

Deletion Audit Log

Every deletion is logged with order details, admin user, IP address, method, and timestamp.

Admin Configuration

Full control over button appearance, safety requirements, allowed statuses, and mass delete limits.

Key Features

• Delete Button on Order View — configurable button with custom text and color on every order detail page
• Mass Delete Action — select multiple orders from the grid and delete them all at once
• Double Confirmation Modal — confirmation popup with order details and data impact warning
• Type Order ID to Confirm — inspired by GitHub's repo delete flow, requires typing the exact order number to proceed
• Per-Status Restrictions — only allow deletion of orders with specific statuses (Pending, Canceled, etc.)
• Configurable Related Data Deletion — choose whether to delete invoices, shipments, credit memos, and payment transactions
• Complete Audit Trail — every deletion logged with order snapshot, admin user, IP address, timestamp, and method
• Mass Delete Safety Limit — configurable maximum orders per mass action (default: 50)
• ACL Permissions — separate permissions for single delete, mass delete, and log viewing
• Transaction-Safe — all deletions wrapped in database transactions with automatic rollback on failure
• Quote Cleanup — optionally removes the associated quote, quote items, addresses, payments, and shipping rates
• Magento-Native Styling — button and modal match Magento's admin design language perfectly
• MEQP Compliant — passes Adobe Marketplace code quality standards
• Zero Frontend Impact — admin-only module, no storefront code

What Gets Deleted

When you delete an order, the following data is permanently removed (each configurable):

Safety Controls

Panth Order Cleanup is designed with safety first. Multiple layers of protection prevent accidental data loss:

Layer 1: Admin Permissions (ACL)

• Panth_OrderCleanup::delete_order — required to see and use the delete button
• Panth_OrderCleanup::mass_delete — required for mass delete action
• Panth_OrderCleanup::view_log — required to view deletion log

Layer 2: Confirmation Modal

• Shows exactly what data will be deleted (invoices, shipments, credit memos, quote data)
• Warns that the action is permanent and cannot be undone

Layer 3: Type Order ID to Confirm

• User must type the exact order increment ID (e.g., 000000031) before the delete button becomes active
• Inspired by GitHub's repository deletion flow — the gold standard for destructive action confirmation

Layer 4: Status Restrictions

• Configure which order statuses are allowed for deletion
• Example: only allow deleting "Pending" and "Canceled" orders, protecting "Complete" and "Processing" orders

Layer 5: Mass Delete Safety Limit

• Configurable maximum number of orders per mass action (default: 50)
• Prevents accidentally selecting "all" and deleting thousands of orders

Layer 6: Database Transactions

• Every deletion is wrapped in a transaction
• If any step fails, everything is rolled back — no partial deletions

Layer 7: Audit Log

• Every deletion is permanently logged with full order details
• Cannot be disabled independently of the deletion feature
• Tracks who deleted what, when, from where, and how

How It Works

Single Order Deletion

1. Admin opens an order detail page
2. Clicks the "Delete This Order" button
3. Confirmation modal appears showing all data that will be deleted
4. Admin types the order number to confirm (if enabled)
5. Clicks "Yes, Permanently Delete"
6. Module checks: enabled? allowed status? ACL permission?
7. Database transaction begins
8. Related data deleted (invoices, shipments, credit memos, transactions)
9. Order items, payments, addresses, status history, tax deleted
10. Quote and quote-related data deleted
11. Order and order grid record deleted
12. Transaction committed
13. Deletion logged to audit trail
14. Admin redirected to order grid with success message

Mass Deletion

1. Admin selects orders in the order grid
2. Chooses "Delete Orders (Permanent)" from mass actions
3. Confirmation dialog appears with warning
4. Module checks safety limit (default: 50 orders max)
5. Each order processed individually through the same deletion flow
6. Success/failure count reported with detailed messages

Deletion Audit Log

Navigate to Panth Infotech > Order Cleanup > Deletion Log to view all deletions.

The log captures:

The audit log is stored in the panth_order_deletion_log database table and persists even if the order data is gone — providing a permanent record for accounting and compliance.

Troubleshooting

Compatibility

Installation

Composer (Recommended)

composer require mage2kishan/module-order-cleanup
bin/magento module:enable Panth_Core Panth_OrderCleanup
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Manual Installation

1. Download and extract to app/code/Panth/OrderCleanup/
2. Run the enable commands above

Verify

bin/magento module:status Panth_OrderCleanup
# Module is enabled

Navigate to Sales > Orders to see the mass delete action, or open any order to see the delete button.

Configuration

Navigate to Stores > Configuration > Panth Extensions > Order Cleanup.

General

Delete Button on Order View

Safety & Data Controls

Mass Delete

License

Proprietary — see LICENSE.txt. One license per Magento production installation.