This patch release includes minor fixes to the core and admin packages, squashing some pesky bugs! :)

Changes

Core

• Fix Google feed excluding simple products without option variants (#13618)
• Fix deleting products w/o translations on non-default locale (#13613)

Admin

• Fix info banner in address form by @KacperMekarski in #13624
• Fix admin export to apply filters correctly #13616
• Fix price parsing for non-English locales (#13627)
• Fix reverse proxy support in admin Table API by using route helpers (#13646)
• Fix price localization for product edit screen (#13647)

Update

Run in your project root:

bundle update

Full Changelog: v5.3.3...v5.3.4

This patch release includes minor fixes to the core and admin packages, squashing some pesky bugs! :)

Changes

Core

• Fix race condition between saving invitation and sending email b7d053b
• Prevent NoMethodError in StoreProduct#refresh_metrics! when product is nil by @damianlegawiec in #13531

Admin

• Fixed validation error on admin address for not persisted address by @brozek95 in #13526
• Fixed edit policy path to use ID rather than slug e1f69b5

Update

Run in your project root:

bundle update

Full Changelog: v5.3.2...v5.3.3

This patch release includes Security fixes plus general improvements. All users are strongly encouraged to upgrade immediately.

Security Fixes

• GHSA-g268-72p7-9j6j (spree_api gem)
• GHSA-p6pv-q7rc-g4h9 (spree_storefront gem)

Supported Versions

Security patches are available for all currently supported Spree versions:

If you're running an unsupported version, please upgrade as soon as possible. Unsupported versions will not receive security patches. Need help upgrading? Contact the Spree team.

Upgrade

bundle update

Other changes

Core

• Fixed incorrect total applied store credit by @resool in #13512
• Manually specify event_serializer_class for Reports/Exports/Imports by @damianlegawiec in #13523

Admin

• Replace partials with helper methods for rendering admin navigation by @damianlegawiec in #13519
• Fixed admin table search field losing focus after loading search res… by @damianlegawiec in #13522

Storefront

• fix mobile nav initial transform by @dimidev in #13515

Full Changelog: v5.3.1...v5.3.2

This is a security patch release addressing two security vulnerabilities. All users are strongly encouraged to upgrade immediately.

Security Fixes

• GHSA-g268-72p7-9j6j (spree_api gem)
• GHSA-p6pv-q7rc-g4h9 (spree_storefront gem)

Supported Versions

Security patches are available for all currently supported Spree versions:

If you're running an unsupported version, please upgrade as soon as possible. Unsupported versions will not receive security patches. Need help upgrading? Contact the Spree team.

Upgrade

bundle update

This is a security patch release addressing two security vulnerabilities. All users are strongly encouraged to upgrade immediately.

Security Fixes

• GHSA-g268-72p7-9j6j (spree_api gem)
• GHSA-p6pv-q7rc-g4h9 (spree_storefront gem)

Supported Versions

Security patches are available for all currently supported Spree versions:

If you're running an unsupported version, please upgrade as soon as possible. Unsupported versions will not receive security patches. Need help upgrading? Contact the Spree team.

Upgrade

bundle update

This is a security patch release addressing two security vulnerabilities. All users are strongly encouraged to upgrade immediately.

Security Fixes

• GHSA-g268-72p7-9j6j (spree_api gem)
• GHSA-p6pv-q7rc-g4h9 (spree_storefront gem)

Supported Versions

Security patches are available for all currently supported Spree versions:

If you're running an unsupported version, please upgrade as soon as possible. Unsupported versions will not receive security patches. Need help upgrading? Contact the Spree team.

Upgrade

bundle update

This is a security patch release addressing GHSA-g268-72p7-9j6j

Supported Versions

Security patches are available for all currently supported Spree versions:

If you're running an unsupported version, please upgrade as soon as possible. Unsupported versions will not receive security patches. Need help upgrading? Contact the Spree team.

Upgrade

bundle update

Ruby 4.0 support

This patch release fixes Spree installation on Ruby 4.0, so you can now use Spree on the latest version of Ruby :)

Other changes

Core

• fix[v-3311]: gift cards - add user validation to Apply class by @resool in #13505
• Add Ruby 4.0 support by @damianlegawiec in #13511
• Add item_group_id to required_attributes for Google data feed by @mbajur in #13506

Storefront

• FIX clear token cookie by @brozek95 in https://github.com/spree/spree/pull/134993

Page Builder

• Fix Rails 8.1 ActiveRecord::EagerLoadPolymorphicError by @damianlegawiec in #13504

Documentation

• Fix link to Developer Guides in user documentation by @chrislaai in #13498

Full Changelog: v5.3.0...v5.3.1

Spree 5.3 with new Pricing engine, Customer Groups and Events & Subscribers workflows

Spree 5.3 continues the momentum of the biggest Spree release ever — Spree 5 — delivering major architectural improvements, like a new powerful pricing engine and support for event-driven workflows, making framework customization easier and more future-proof.

This release builds on the foundations laid in 5.0, 5.1, and 5.2 by introducing flexible pricing engine, customer groups, a pub/sub event system, modernized admin UI, and enhanced developer tools — all while keeping Spree fully open source and community-driven.

Highlights

New Pricing Engine (Price Lists)

A flexible pricing system for managing pricing strategies — essential for B2B, multi-region, wholesale, and marketplace use cases.

• Customer Group pricing — Offer different prices to VIP, wholesale, or B2B customers.
• Volume pricing — Automatic discounts when item quantity falls within min–max ranges.
• Zone-based pricing — Regional pricing based on customer location.
• User-specific pricing — Individual pricing for key accounts.
• Time-based activation — Schedule price lists with start and end dates.
• Bulk Editor — use spreadsheet-like UI to manage prices for multiple products in multiple currencies with ease, also with keyboard shortcuts :)

Learn how to set up Price Lists in Spree Commerce.

Events & Subscribers Engine

A powerful new event system that allows you to react to various actions happening in your application. When something happens (an order is placed, a product is updated, or inventory changes), Spree publishes an event that your code can subscribe to and handle.

• Loose coupling — Connect and extend Spree without modifying core code.
• Multiple event types — Order, payment, shipment, product, customer, and more.
• Wildcard subscriptions — Subscribe to order.* to catch all order events.
• Sync or async — Run handlers immediately or via ActiveJob. Async default!
• Custom events — Publish your own events from anywhere in your application.

Perfect for sending notifications, syncing with external services, logging audit trails, triggering webhooks, and updating caches.

Learn how to work with Events in Spree Commerce.

Customer Groups

Segment your customers into defined groups for personalized experiences and targeted business rules.

• Flexible grouping — Create unlimited customer groups (VIP, Wholesale, B2B, Early Access, etc.).
• Price List integration — Apply custom pricing to specific customer groups.
• Promotion rules — Restrict promotion eligibility to certain customer segments.
• Easy management — Add and remove customers from groups directly in the admin.

Learn how to set up Customer Groups in Spree Commerce.

Webhooks 2.0 with Admin UI

A completely revamped webhook system with full admin panel management, built on top of the new Events engine.

• Admin panel management — Create and manage webhook endpoints directly from Settings > Developers > Webhooks.
• Event filtering — Subscribe to specific events or use wildcards (e.g., order.*).
• HMAC-SHA256 signatures — Secure payload verification for all deliveries.
• Automatic retries — Failed deliveries retry up to 5 times with exponential backoff.
• Full audit trail — Track every delivery attempt with response codes, timing, and error details.
• Multi-store support — Each store can have its own webhook endpoints.

Learn how to configure Webhooks in Spree Commerce.

Tailwind CSS Admin Dashboard

The admin dashboard has been completely rebuilt with Tailwind CSS, replacing Bootstrap entirely.

• Modern, clean, and consistent design language throughout the entire admin interface.
• Faster page loads and smaller CSS bundle size.
• Easier customization using Tailwind's utility-first approach.
• Improved responsive design for mobile and tablet admin access.

Admin Tables Component

A new flexible table system for displaying resource listings in the admin dashboard with a powerful DSL for customization.

• Declarative API — Define table configurations with customizable columns, sorting, filtering, and bulk actions.
• Multiple column types — String, number, money, status, boolean, datetime, link, image, association, and custom partials.
• Query builder filters — Advanced filtering with autocomplete, select, date ranges, and more.
• Bulk actions — Select multiple rows and perform batch operations.
• Extensible — Add columns to existing tables, insert at specific positions, or create entirely new tables.

Learn how to work with Admin Tables in Spree Commerce.

Order Adjustments & Order Promotions

A new admin experience for managing order promotions and order adjustments.

• Order promotions — Manually add promotions to the order in the admin panel
• Order adjustments — Manually add charges or credits to existing orders with streamlined payment/refund handling.

Learn how to create Promotions and manage Order Adjustments in Spree Commerce.

Admin Order & Customer Notes

Add internal notes to orders and customers for better team communication and order tracking.

• Staff notes — Add internal comments visible only to admin users.
• Order history — Keep a record of important order-related communications.
• Team collaboration — Share context about special handling, customer requests, or issues.

What's Next

Spree 5.4 will include another batch of impressive changes, such as:

• New REST API built around simplicity, ease of use, and performance (around 10x faster than API v2!)
• TypeScript SDK allowing developers leverage the new API with a great developer experience and type safety!
• Next.js storefront starter kit powered by the new API and TypeScript SDK
• Multi-channel support allowing developers to build and manage a truly omnichannel experience

Contributors

A huge thank-you to everyone who contributed ideas, code, testing, issue reports, documentation, and feedback.

New Contributors

• @malakada made their first contribution in #13421
• @carl-lee-lu made their first contribution in #13441
• @MuhammadIbtisam made their first contribution in #13463
• @FrederikKragh made their first contribution in #13484

Full Changelog: v5.2.3...v5.3.0

Installation

Paste this into your terminal, and our guided installer will setup everything for you. You'll also be able to choose which Spree modules to install.

bash -c "$(curl -fsSL https://spreecommerce.org/install)"

Upgrading from earlier versions?

Please follow our Spree 5.3 upgrade guide.

Full Changelog: v5.2.3...v5.3.0.rc2