Major/New Features

3.5 is a smaller release to lay the groundwork for major new features described in Spree Development Roadmap. It also contains number of bug fixes and improvements besides described in this document.

Multi-store management

We’ve added an ability to manage multiple stores in one Spree instance of your application. Thanks to that you can easily create stores per region / language / currency. This feature will be enhanced in the next releases.

Contributed by Spark Solutions

Extracted Analytics tracker into an Extension

Our goal is always to keep the core Spree lean and flexible that’s why we’ve moved all of the code of Analytics Trackers to an Extension which you can use with any Spree 3.1+ version.

Spree Analytics Trackers extension currently supports Google Analytics and

Contributed by Spark Solutions

Admin Panel views exporter

You can easily copy all of the default spree admin Panel into your project with just one command line:

rails g spree:backend:copy_views

We hope will make backend customization the Admin Panel a lot easier.

Contributed by supatk


Add Spree gems to Gemfile

gem 'spree', '~> 3.5.0'
gem 'spree_auth_devise', '~> 3.3'
gem 'spree_gateway', '~> 3.3'

Run bundle install

Use the install generators to set up Spree

rails g spree:install --user_class=Spree::User
rails g spree:auth:install
rails g spree_gateway:install


Update Gemfile

gem 'spree', '~> 3.5.0'

Run bundle update

Install missing migrations

rails spree:install:migrations
rails spree_auth:install:migrations
rails spree_gateway:install:migrations

Run migrations

rails db:migrate

Other Gotchas

Install Spree Analytics Trackers extension

If you were previously using Analytics Trackers feature you need to install it as an extension as it was extracted from the core.

  1. Add Spree Analytics Trackers to your Gemfile:

ruby gem 'spree_analytics_trackers', github: 'spree-contrib/spree_analytics_trackers'

  1. Install the gem using Bundler:

bash bundle install

  1. Copy and run migrations:

bash bundle exec rails g spree_analytics_trackers:install

You’re good to go!

Noteworthy Changes

Also please review each of the noteworthy changes, and ensure your customizations or extensions are not effected. If you are affected by a change, and have any of your own tips please submit a PR to help the next person!

Full Changelog

You can view the full changes using Github Compare.