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.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