Trash (Soft-Delete)

Overview

The trash is a safety feature available from the Pro plan. Instead of immediately deleting orders, they are moved to the trash and can be restored if needed.

How Does It Work Technically?

When deleting, the order is not removed from Shopify
Instead, tags are added to the order:

- delete-app:in-trash – marks the order as "in trash" - delete-app:trashed:2026-02-14 – expiry date

The order is hidden from the normal order list (via tag filter)
A snapshot of the order data is saved in the app database

Restoring

Open the Trash (in the menu)
Find the desired order
Click "Restore"
The tags are removed → the order reappears immediately in Shopify!

Bulk Restore

Select multiple orders via checkbox
Click "Restore selected"

Auto-Purge

After the retention period expires, orders are automatically permanently deleted:

Default retention: 48 hours
Configurable under Settings → Trash
The purge job runs daily at 3:00 AM (store timezone)

Status Overview

Status	Meaning
🟡 In Trash	Order waiting for permanent deletion
🟢 Restored	Order was successfully restored
🔴 Permanently Deleted	Order was deleted after expiry
⚠️ Error	Shopify could not delete the order
👁️ Hidden	Shopify prevents the order from being deleted

Statistics

The trash shows realtime statistics:

Number of items in trash

Next scheduled auto-purge time

Total number of restored orders

Recommendation: Enable the trash! It provides an extra safety layer and prevents accidental deletions.