Skip to main content

​
Update your Rails version to 5.1

Spree 3.3 requires Rails 5.1 at a minimum. Please follow the official Rails guide to upgrade your application.

​
Update gems

bundle update

​
Install missing migrations

rake railties:install:migrations

​
Run migrations

rails db:migrate

​
Include UserMethods in your User class

With this release, we’re not including this automatically. You need to do it manually if you’re not using spree_auth_devise. You need to include Spree::UserMethods in your user class, eg. 
class User
  include UserAddress
  include UserMethods
  include UserPaymentSource
end

​
Update aws-sdk gem to >= 2.0

Spree 3.3 comes with paperclip 5.1 support so if you’re using Amazon S3 storage you need to change in your Gemfile, from: 
gem 'aws-sdk', '< 2.0'
to: 
gem 'aws-sdk', '>= 2.0'
and run bundle update aws-sdk In your paperclip configuration, you also need to specify s3_region attribute eg. https://github.com/spree/spree/blame/master/guides/content/developer/customization/s3_storage.md#L27 See also RubyThursday episode walkthrough of upgrading paperclip in your project.

​
Add jquery.validate to your project if you’ve used it directly from Spree

If your application.js file includes line //= require jquery.validate/jquery.validate.min you will need to add this file manually to your project because this library was removed from Spree in favor of native HTML5 validation.

​
Read the release notes

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