Before proceeding to upgrade, please ensure you’re at Spree 4.10

This guide is a work in progress. If you find any issues, please report them. If you want to contribute to this guide, please click “Suggest edits” at the bottom of this page. Thank you!

Spree 5.0 is a major upgrade that introduces many breaking changes. The major changes are:

  • Dropped support for Rails < 7.2
  • Dropped support for Spree Auth Devise gem (now using Devise gem directly via generator)
  • Completely new modern mobile-friendly Storefront (old customizations won’t work)
  • Completely new Admin Dashboard (old customizations won’t work)
  • Completely new native Stripe extension

Prerequisites

Before upgrading, please ensure you have the following prerequisites:

Upgrade steps

Read the release notes

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