Upgrade Guide
Guides for upgrading your Shopper installation between versions.
Shopper documentation always reflects the latest release of the current major version. When a new minor version ships, the docs are updated to match. Upgrade guides document every breaking change, new feature, and migration step between versions.
Before You Start
Before upgrading, take these precautions:
- Back up your database. E-commerce data (orders, customers, prices) is difficult to recover if a migration fails.
- Run the upgrade on a staging environment first. Verify everything works before touching production.
- If upgrading across multiple versions (e.g., v2.2 to v2.5), follow each guide in sequence. Do not skip versions.
Upgrade Guides
| From | To | Summary |
|---|---|---|
| v2.9 | v2.10 | Security release: admin authorization audit, slide-over IDOR fix, exact tax on discounted totals (TaxableItem contract change), atomic stock reservation (StockReserver contract, Stockable::tracksInventory()), guest per-user discount block. No database migrations |
| v2.8 | v2.9 | Laravel 13 support, onboarding wizard rebuilt on Filament Schema, cache stores scalars instead of models, Stripe SDK upgraded to v19. No database migrations |
| v2.7 | v2.8 | Security release: authorization guards across admin Livewire components, atomic discount reservation, orders discount snapshot columns |
| v2.6 | v2.7 | Money values stored in smallest currency unit (cents), slide-over components replaced, 2FA split into SOLID interfaces |
| v2.5 | v2.6 | Cart package, tax system, auth models moved to admin package, event renaming, render hooks |
| v2.4 | v2.5 | Order system split into three independent statuses (order, payment, shipping), payment drivers, shipment tracking |
| v2.2 | v2.3 | Product Tags feature with new permissions and feature flag |
| v2.1 | v2.2 | Repository pattern removed, Model Contracts system, Filament v4, ShopperUser trait, sidebar redesign |
There is no upgrade guide for v2.3 to v2.4. That release only added Spanish translations and internal render hooks with no breaking changes.
Getting Help
If you encounter issues during an upgrade:
- Check the GitHub Issues
- Join the Discord community
- Review the changelog
Last updated on
Edit on GitHub