Skip to main content
Before proceeding to upgrade, please ensure you’re at Spree 4.4 or later and Rails 6.1 or later.

Upgrade steps

1. Update gems

2. Install and run missing migrations

3. (Optional) Install importmap-rails gem

We’ve switched to using importmap-rails for asset management. If you’re using the spree_backend or spree_frontend gem, you’ll need to install the importmap-rails gem.
and run generators:
You can also remove the jsbundling-rails gem from your Gemfile:

4. (Optional) Apply fix when upgrading from 4.5/4.6/4.7

If you’re upgrading from 4.5/4.6/4.7, you need to set this configuration in your config/initializers/spree.rb:

Read the release notes

For information about changes contained within this release, please read the Spree 4.8.0 Release Notes.