3.6 to 3.7

This guide covers upgrading a 3.6 Spree application, to version 3.7.

Update Gemfile
gem 'spree', '~> 3.7.0'
gem 'spree_auth_devise', '~> 3.5'
gem 'spree_gateway', '~> 3.4'
Run bundle update
Install missing migrations
rails spree:install:migrations
rails spree_api:install:migrations
rails spree_auth:install:migrations
rails spree_gateway:install:migrations
Run migrations
rails db:migrate
Migrate Taxon icons to Spree Assets
We renamed TaxonIcon to TaxonImage to clarify usage of this model. If you were using TaxonIcon please run this to migrate your icons to images:
rails db:migrate_taxon_icons_to_images
Ensure all Orders associated to Store
Orders needs to be associated to Stores. To ensure all existing Order are associated with Store please run this:
rails db:associate_orders_with_store
This will associate all Orders without Store to the default Store. This can take some time depending on your volume of data.
Ensure all Orders have currency present
To enhance multi currency capabilities we've made currency presence obligatory in Order model. To ensure all existing Orders have currency present please run this command:
rails db:ensure_order_currency_presence
This will set currency in Orders without currency set to Spree::Config[:default_currency] value. This can take some time depending on your volume of data.
Replace guest_token with token in your codebase
Order#guest_token was renamed to Order#token in order to unify the experience for guest checkouts and orders placed by signed in users.
Read the release notes
For information about changes contained within this release, please read the 3.7.0 Release Notes.

3.7 to 4.0

3.5 to 3.6

Last modified 1yr ago

3.6 to 3.7

Update Gemfile

Run `bundle update`

Install missing migrations

Run migrations

Migrate Taxon icons to Spree Assets

Ensure all Orders associated to Store

Ensure all Orders have currency present

Replace `guest_token` with `token` in your codebase

Read the release notes