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.Documentation Index
Fetch the complete documentation index at: https://docs.laravelshopper.dev/llms.txt
Use this file to discover all available pages before exploring further.
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.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