Spree Commerce
Open-source headless ecommerce platform with a REST API and Next.js storefront
Alternative to: Shopify, Magento, WooCommerce, Salesforce Commerce Cloud
v5.5.3
2026-07-10This release improves CSV import performance, adds Store API product filter serializers, and fixes several admin-related bugs.
v5.5.2
2026-07-06This release provides various fixes and improvements across core logic, API caching, admin styling, and email image rendering.
v5.5.1
2026-06-29Introduces a new Channel Price List Rule to target specific sales channels, along with various core, API, and admin fixes.
v5.5.0
2026-06-18Spree Commerce 5.5 introduces an Admin API with a TypeScript SDK, AI-driven developer tools, sales channels, stock reservations, and advanced order routing for multi-channel sellers.
spree/sdk@1.1.0
2026-06-11Introduces provider-dispatched login, newsletter subscription management, sales-channel selection, and enhanced Product and Customer API fields.
v5.4.3
2026-05-19This release provides numerous community fixes, admin improvements, and a security patch to prevent CSV formula injection attacks.
v5.3.6
2026-05-19This security patch addresses a moderate CSV formula injection vulnerability in customer CSV exports.
v5.2.8
2026-05-19This security patch fixes a moderate CSV formula injection vulnerability in Customer CSV exports.
v5.4.2
2026-04-27This release introduces a parallel CSV importer, official Adyen and PayPal payment integrations, and performance improvements for the Products API handling large SKU collections.
v5.4.1
2026-04-14This release includes various bug fixes for core functionality, API enhancements for customer creation and payments, admin UI improvements, and updated documentation.
spree/sdk@1.0.1
2026-04-14Added SDK extension capabilities, improved documentation, and missing totals for DeliveryRate and Fulfillment.
spree/sdk@1.0.0
2026-04-11Initial stable release of the official TypeScript SDK for Spree Commerce Store API v3, featuring full API coverage, TypeScript types, and multiple authentication modes.
v5.4.0
2026-04-08Spree 5.4 transforms into an API-first platform featuring Store API v3, a TypeScript SDK, Next.js storefront, multi-region Markets support, and a new provider-agnostic payment interface.
v5.4.0.rc3
2026-03-25Adds EU Omnibus Directive support for price tracking and introduces several API changes, including split endpoints for discount codes and gift cards.
v5.4.0.rc2
2026-03-23Introduces agent-native development tools with automatic documentation for AI agents, alongside various improvements to the API, Core, and Admin interface.
v5.4.0.rc1
2026-03-20Spree 5.4 transforms into an API-first platform featuring Store API v3, a TypeScript SDK, a Next.js storefront, a new Payment Sessions API, and integrated Markets for multi-region commerce.
v5.3.5
2026-03-12This patch release provides bug fixes for store credits and gift cards, security improvements for webhooks, and general fixes for the admin interface.
v5.3.4
2026-02-23This patch release addresses various bugs across the core and admin packages, including fixes for Google feeds, product deletions, and admin localization and exports.
v5.3.3
2026-02-16This patch release fixes bugs in the core and admin packages, including race conditions, NoMethodErrors, and validation issues.
v5.3.2
2026-02-05This patch release provides critical security fixes for the spree_api and spree_storefront gems along with general core, admin, and storefront improvements.
v5.2.7
2026-02-05This security patch release addresses two vulnerabilities within the spree_api and spree_storefront gems.
v5.1.10
2026-02-05This security patch release addresses two vulnerabilities affecting the spree_api and spree_storefront gems across supported versions.
v5.0.8
2026-02-05This security patch release addresses two vulnerabilities affecting the spree_api and spree_storefront gems.
4.10.3
2026-02-05Security patch release addressing a vulnerability identified in GHSA-g268-72p7-9j6j across supported versions.
v5.3.1
2026-02-02This patch release adds Ruby 4.0 support and includes various bug fixes for gift cards, Google data feeds, the storefront, and the page builder.
v5.3.0
2026-01-26Spree 5.3 introduces a new pricing engine, customer groups, an event-driven pub/sub system, a Tailwind CSS admin dashboard, and revamped webhooks.
v5.3.0.rc2
2026-01-22This release is a release candidate for version 5.3.0, containing updates and preparations for the stable launch.
v5.2.6
2026-01-15Adds Rails 8.1 support, introduces a Ransack Customization DSL, and implements various performance and accessibility improvements across the storefront, API, and core engine.
v5.2.5
2026-01-08This security release fixes two IDOR vulnerabilities involving guest address exposure and order modification.
v5.1.9
2026-01-08This security release addresses two IDOR vulnerabilities related to guest address exposure and order modification.
v5.0.7
2026-01-08This security release fixes two IDOR vulnerabilities involving guest address exposure and authenticated order modification.
v4.10.2
2026-01-08This security release patches two IDOR vulnerabilities affecting guest address exposure and order modification.
v5.2.4
2025-12-18This patch release includes bug fixes for the product scope, admin dashboard, and storefront, alongside compatibility updates for Bundler 4.0 and Ruby 3.4+
v5.2.3
2025-12-16This patch release includes performance improvements for SalesTotal reports, new payment method icons, various bug fixes for Admin and Storefront, and updated documentation.
v5.2.2
2025-12-09Introduces background image processing with named variants, improves the Spree Dependencies developer experience, and includes various core, API, and admin fixes.
v5.2.1
2025-12-02This patch release introduces Permission Sets for modular role-based permission management and includes various core, admin dashboard, and documentation fixes.
v5.2.0
2025-11-28Spree 5.2 introduces metafields, a visual CSV importer, updated product detail pages, store policies, and enhanced developer tools including a new CLI and Tailwind 4 support.
v5.2.0.rc3
2025-11-18This release includes various bug fixes for the installer, storefront templates, admin collection handling, and updates to user documentation.
v5.2.0.rc2
2025-11-09This release introduces an interactive installer, a date filter for admin users, and various bug fixes for CSV imports, payments, and the admin interface.
v5.2.0.rc1
2025-11-04Upgrades Spree to version 5.2, introducing various feature enhancements and dependency updates.
v5.1.8
2025-10-30This release includes various bug fixes for core services, admin functionality, and the storefront, along with improvements to payment methods and Stimulus controller overrides.
v5.1.7
2025-09-29This release removes the currency_select dependency and includes various fixes for the storefront, admin panel, and core pricing logic.
v5.1.6
2025-09-18This release includes various bug fixes and performance improvements across the Storefront, Admin Dashboard, API, and Core, including legacy browser support and N+1 query optimizations.
v5.1.5
2025-08-06This release introduces new UIs for custom domains and tax rates, Claude Code integration, payment gateway enhancements, and various admin and API fixes.
v5.0.6
2025-08-06Introduces a new Devise generator for storefronts and includes various fixes for product slugs, address validation, API image URLs, and domain handling.
v5.1.4
2025-07-24This release includes administrative UI improvements, bug fixes for product slugs, and new injection points for UI extensibility.
v5.1.3
2025-07-20This release includes improvements to custom domain handling, email URL generation, admin UI enhancements, and minor bug fixes.
v5.1.2
2025-07-14This release includes several bug fixes for the API, admin forms, and datepicker, along with UX improvements and updated parameter permissions for Spotify and Discord.
v5.1.1
2025-07-08This release introduces checkout integration tests, restores the track inventory checkbox, updates mail image formats, and improves digital item checkout and translations.
v5.1.0
2025-07-03Spree 5.1 introduces native gift cards, admin staff management, enhanced checkout customization, and built-in integrations for Google Analytics 4 and Klaviyo, alongside Rails 8 support in the starter template.
v5.0.5
2025-06-30This patch release introduces various bug fixes, performance optimizations, UI improvements, and enhancements to the Admin, Storefront, and API layers, including a new Extension Generator 2.0.
v5.0.4
2025-05-22This release introduces admin interface improvements, page builder upgrades, storefront enhancements, and several bug fixes across the platform.
v5.0.3
2025-05-06This release introduces custom page sections and blocks, improves the Admin Customers view, adds essential storefront SEO files, and includes various bug fixes.
v5.0.2
2025-04-22This release introduces an option to exclude quick checkout addresses from the API, fixes various bugs regarding locales, slugs, and Safari cart behavior, and improves admin interface elements.
v5.0.1
2025-04-09This release includes various bug fixes, admin template improvements, Stripe API documentation updates, and new helper methods for images and modals.
v5.0.0
2025-04-03Spree 5 introduces a completely redesigned admin dashboard, enhanced digital product flows, bulk operations, a new reporting engine, and improved promotions and taxons management.
v4.10.0
2024-09-06This release adds Rails 7.2 support, automatic shipment tracking URL generation, a license change to AGPL-3.0, and introduces Spree Enterprise Edition.
v4.9.0
2024-08-14This release improves performance and introduces new Storefront API endpoints for Wishlists and Variants, enhanced webhooks, more flexible store credits, and Sentry error reporting integration.
v4.8.3
2024-06-13This release updates spree_cli extension documentation and sets the default locale in ControllerHelpers::Locale for translation column fallbacks.
v4.8.2
2024-05-29Fixes backwards compatibility for translations.
v4.8.1
2024-05-27Fixed an issue where the Spree::Prefence constant was uninitialized when setting configuration.
v4.8.0
2024-05-27Spree v4.8 introduces simplified translation handling, a rewritten documentation site, a new look and feel, and replaces Node with Importmap for both Admin and Storefront.
v4.7.3
2024-05-05Fixed name clashing by ensuring Spree concerns are included with the Spree namespace.
v4.6.6
2024-05-05Ensures Spree concerns are included with the Spree namespace to prevent naming conflicts.
v4.5.5
2024-05-05Fixed potential name clashing by ensuring Spree concerns are always included with the Spree namespace.
v4.7.2
2024-04-21Restores OrderContents and store credit methods to simplify the upgrade process to Spree 4.
v4.6.5
2024-04-21Restores OrderContents and store credit methods to simplify the upgrade process to Spree 4.
v4.5.4
2024-04-21Restored OrderContents and store credit methods to facilitate upgrading to Spree 4.
v4.4.1
2024-04-21This release restores OrderContents and store credit methods to facilitate Spree 4 upgrades and fixes an inventory unit merge issue.
v4.3.3
2024-04-21Reintroduces OrderContents and store credit methods to facilitate Spree 4 upgrades and adds an empty state option to the frontend.
v4.2.7
2024-04-21Restores OrderContents and store credit methods to facilitate upgrades to Spree 4.
v4.1.15
2024-04-21Restores OrderContents and store credit methods to facilitate the upgrade to Spree 4.
v4.0.9
2024-04-21Restores OrderContents and store credit methods to simplify the upgrade process to Spree 4.
v4.7.1
2024-01-09Fixes Mobility locale normalization.
v4.6.4
2024-01-09Fixed Mobility locale normalization.
v4.7.0
2023-11-09Spree 4.7 adds support for Rails 7.1, introduces an interface for customizing the admin panel without deface, and removes support for Ruby 2.7.
v4.6.3
2023-11-09The required Rails version is now pinned to less than 7.1.
v4.6.2
2023-09-04Added authorized clicks and days to the Store factory and improved translated slug generation in models.
v4.6.1
2023-07-24Sets the fallback locale for Mobility based on the current store for Spree 4.6.
v4.6.0
2023-05-31Introduces built-in content translations for core entities and data feeds for Google Merchant Center and Meta Ad Manager, along with enhanced webhook security and API support.
v4.5.3
2023-05-14Fixed an issue with the spree_cli extension.
v4.5.2
2023-04-21Fixed metadata namespace usage for Spree 4.5.
v4.5.1
2023-01-18Added compatibility for Ruby 3.1 and 3.2.
v4.5.0
2022-12-01Spree 4.5 adds Ruby 3 and Rails 7 support, introduces a new CLI and Platform API SDK, and moves the deprecated V1 API to a standalone gem.
v4.3.2
2022-06-01Backports a security fix for a CSRF issue from Spree 4.4.1.
v4.2.6
2022-06-01Backports a fix for a CSRF security issue.
v4.4.0
2022-01-26Spree 4.4 introduces Webhooks, Platform API, Metadata for customization, digital product downloads, Wishlists, and an improved admin dashboard experience using Hotwire.
v4.4.0.rc2
2022-01-10This release candidate update includes bug fixes and refinements ahead of the v4.4.0 stable release.
v4.3.1
2022-01-09This patch release provides bug fixes for null value errors encountered during migrations.
v4.4.0.rc1
2021-12-04This release introduces significant Platform API expansions, Spree Webhooks, metadata support for resources, and architectural changes including the extraction of frontend and backend into separate repositories.
v4.3.0
2021-09-14Introduces a modular API-first architecture, Next.js Commerce integration, a new Pages & Navigation CMS, Platform API developer preview, and expanded product filtering capabilities.
v4.3.0.rc2
2021-08-23This update focuses on API v2 enhancements, Storefront improvements, documentation migrations, and various bug fixes across the platform and core components.
v4.3.0.rc1
2021-08-11Introduces a modular API-first architecture, a new CMS for pages and navigation, a Platform API developer preview, and advanced product filtering.
v4.2.5
2021-05-31Spree 4.2 adds support for Rails 5.2, 6.0, and 6.1, alongside updates to product validation, dependency flexibility, and various storefront and API fixes.
v4.1.14
2021-05-31Spree 4.1 adds support for Rails 5.2 and 6.0 and fixes compatibility with Doorkeeper 5.5+
v4.0.8
2021-05-31Spree 4.0 adds support for Rails 5.2 and 6.0 and fixes compatibility with Doorkeeper 5.5+
v4.2.3.1
2021-05-05Fixed compatibility issues with Rails versions 6.0.3.7 and 6.1.3.2.
v4.2.3
2021-05-05This patch release includes bug fixes for the Storefront API regarding deleted addresses and admin user scopes for account credit cards.
v4.1.13.1
2021-05-05Fixed compatibility with Rails v6.0.3.7.
v4.0.7.1
2021-05-05Fixed compatibility issues with Rails v6.0.3.7.