Upgrade Guides
Upgrading to Spree 5.0
This guide covers upgrading a Spree 4.10 application to Spree 5.0.
Before proceeding to upgrade, please ensure you’re at Spree 4.10
This guide is a work in progress. If you find any issues, please report them. If you want to contribute to this guide, please click “Suggest edits” at the bottom of this page. Thank you!
Spree 5.0 is a major upgrade that introduces many breaking changes. The major changes are:
- Dropped support for Rails < 7.2
- Dropped support for Spree Auth Devise gem (now using Devise gem directly via generator)
- Completely new modern mobile-friendly Storefront (old customizations won’t work)
- Completely new Admin Dashboard (old customizations won’t work)
- Completely new native Stripe extension
Prerequisites
Before upgrading, please ensure you have the following prerequisites:
- Ruby 3.2 or later
- Rails 7.2 - Upgrade guide for Rails 7.2
Upgrade steps
Read the release notes
For information about changes contained within this release, please read the Spree 5.0 Release Notes.