What Order Change History does#
- Inspect before-and-after shipping and billing addresses.
- Track line items, quantities, totals, discounts, shipping lines, notes and tags.
- Choose which kinds of changes to record.
- Read recent order edits from the order’s Tools block.
Set up Order Change History#
- Open Order Change History in Toolbench and choose Turn on. This module requires Premium or its 14-day trial.
- Review and approve any access request shown by Shopify.
- Allow the starting scan to create snapshots of recent orders.
- In Settings → What to track, enable the categories you need or choose Track everything.
- Choose the history retention period for your support process.
- Make a reversible test-order edit and inspect its change details.
Settings and behavior#
| Setting or field | What it means |
|---|---|
| History retention | 90 days by default; configurable up to 365 days. |
| Snapshot retention | Current-value snapshots have a separate retention setting, defaulting to 30 days. |
| What to track | Categories switched off are not recorded. |
| Usage | Each unique tracked order counts once per billing cycle, even if both order and cart history see it. |
A practical example#
A customer asks which delivery address was originally supplied. Compare the address before and after a recorded edit. This can support an investigation or customer-service conversation; it does not guarantee a dispute outcome.
Permissions and data access#
Reads orders and customers. It does not edit order or customer records.
Access is requested when you turn the module on. Other enabled modules may request their own permissions.
Requirements and limits#
- The scan saves current values; it does not import an old edit history.
- Older orders are subject to Shopify access permissions and available saved snapshots.
- The first 1,000 tracked orders per billing cycle are included in Premium; additional usage is billed separately.
If something is not working#
- For a missing category of edit, check What to track.
- If the Tools block is absent, check staff access and pin it on an order page.
- An edit without a previous value may have arrived before a snapshot was available.