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

bundle update

​
2. Install and run missing migrations

bin/rake spree:install:migrations && bin/rails db:migrate

​
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. 
bundle add importmap-rails
and run generators: 
bin/rails importmap:install && bin/rails turbo:install && bin/rails stimulus:install
You can also remove the jsbundling-rails gem from your Gemfile: 
bundle remove jsbundling-rails

​
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: 
Spree::RuntimeConfig.always_use_translations = true

​
Read the release notes

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