Order Cleanup — Safely Delete Orders for 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.

• Key Features
• What Gets Deleted
• Safety Controls
• Compatibility
• Installation
• Configuration
• How It Works
• Deletion Audit Log
• Troubleshooting
• FAQ
• Support

• 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

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

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

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.

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

General

Delete Button on Order View

Safety & Data Controls

Mass Delete

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

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.

Is this safe to use on production?

Yes. The module includes 7 layers of safety controls (ACL, confirmation modal, type-to-confirm, status restrictions, mass delete limit, database transactions, and audit logging). It was designed for production use where store owners need to clean up test orders or remove unwanted transactions.

Can I recover a deleted order?

No. Deletion is permanent — that's the point. However, the deletion log preserves a snapshot of the order data (customer, items, totals, timestamps) for accounting and audit purposes. We strongly recommend keeping the deletion log enabled.

Does it delete from third-party tables?

No. The module only deletes from core Magento sales and quote tables. If you have third-party extensions that add related tables (e.g., custom shipping providers, ERP sync logs), those records may become orphaned. Check with your extension vendors.

Does it affect reports?

Yes. Deleted orders are removed from all Magento reports since the underlying data no longer exists. The deletion log can serve as an alternative record for accounting.

Can I restrict who can delete orders?

Yes. The module uses Magento's ACL system with three separate permissions:

• Panth_OrderCleanup::delete_order — single order deletion
• Panth_OrderCleanup::mass_delete — mass deletion from grid
• Panth_OrderCleanup::view_log — viewing the deletion log

Assign these per admin role under System > Permissions > User Roles.

Does it work with Hyva theme?

Yes. This is an admin-only module — it works identically regardless of your frontend theme (Hyva, Luma, or custom).

What happens if deletion fails midway?

The entire operation is rolled back. Database transactions ensure that either everything is deleted cleanly, or nothing changes. You'll see an error message explaining what went wrong, and the system log will have details.

Can I customize the delete button appearance?

Yes. You can change the button text and color from admin config. The button uses Magento's native admin button classes for consistent styling.

Need Custom Magento Development?

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

Built and maintained by Kishan Savaliya — kishansavaliya.com — Top Rated Plus Magento developer on Upwork with 10+ years of eCommerce experience.

Panth Infotech specializes in high-quality Magento 2 extensions and themes for Hyva and Luma storefronts. Browse our full catalog of 35+ extensions on Packagist and the Adobe Commerce Marketplace.

Quick Links

• kishansavaliya.com
• Get a Quote
• Upwork Profile
• Panth Infotech Agency
• All Packages on Packagist
• GitHub

SEO Keywords: magento 2 delete orders, magento order cleanup, remove test orders magento 2, magento 2 order management, delete invoices shipments magento, magento order deletion extension, magento 2 mass delete orders, magento 2 admin order tools, magento order audit log, magento 2 order cleanup extension, magento delete order safely, magento order deletion log, magento 2 double confirmation delete, magento order status restriction, magento 2 acl order delete, panth order cleanup, panth infotech, mage2kishan, mage2sk, hire magento developer, top rated plus upwork, magento 2 extension developer, magento 2.4.8 delete orders