🎉 Spree 5.2 with New Features and Developer tools

Spree 5.2 continues the momentum of the biggest Spree release ever — Spree 5 — focusing heavily on developer experience, customization capabilities, and enterprise-level workflows.

This release builds on the foundations laid in 5.0 and 5.1 by delivering new tools that make Spree faster to develop, easier to extend, and more flexible for merchants across B2C, B2B, and various use cases.

Expect smoother setup, more powerful low-code customization, richer storefront editing, and new marketing-ready features — all while keeping Spree fully open source and community-driven.

✨ Highlights

🔧 Metafields

A powerful new way to extend any Spree model without writing code or altering your database schema.
Add structured, typed metadata fields to products, variants, orders, customers, and more.

• Manage metafields entirely through the Admin Dashboard or via API.
• Perfect for flexible content, integrations, PIM-style data, custom attributes, and storefront personalization.
• Greatly improves developer experience by allowing non-technical teams to manage additional data without migrations.
• Great for extension developers to save metadata, external IDs and so on

Learn how to define and use metafields in Spree Commerce.

🛠 Developer Tools

Spree 5.2 ships with a suite of improvements designed to make developers dramatically more productive:

• New Spree Installer CLI — spin up a project in seconds, with recommended defaults.
• Spree Generators — instantly scaffold models, admin dashboard components, and boilerplate.
• End-to-End Spree Tutorial — taking beginners from zero to production-ready Spree developers.
• Storefront on Tailwind 4 — build modern, responsive storefronts using the latest Tailwind CSS.
• Admin SDK Enhancements — improved Navigation system, Component library, and Form Builder for rapid admin UI development.
• Spree Dev Tools Gem — write automated tests faster with opinions, helpers, and best practices built in.
• AI Tool Integrations — import Spree-optimized Cursor/Claude rules to streamline agentic coding workflows.

📦 CSV Importer

A visual CSV product importer that is easier, clearer, and fully mappable.

• Upload CSV product files and map your custom columns to the Spree schema.
• Supports bulk product creation and updates.
• Ideal for catalog migrations, PIM exports, or vendor-provided product feeds.

Learn how to import product CSV files in the Spree Commerce dashboard.

📝 Store Policies

A new flexible system for managing terms & conditions, returns, and any additional store policies.

• Create and manage multiple policies directly from Admin.
• Display policies to customers throughout the storefront.
• In Spree Enterprise, multi-vendor stores allow each vendor to manage their own dedicated policies.
  Learn how to set up and manage store policies in Spree Commerce.

🛍 Product Details Page 2.0

A major update to how product pages are built and edited.

• Fully customizable Page Builder sections and blocks.
• Merchandisers can create richer product storytelling without developer involvement.
• Developers gain a more modular, maintainable product page layout system.

Learn how to customize the Product Details Page in Spree Commerce.

✉️ Newsletter Subscribers

Track newsletter signups across your storefront and sync them with Klaviyo for automated email marketing flows.

This helps merchants better understand audience growth and integrate seamlessly with marketing automation workflows in Klaviyo.

🔮 More Coming Soon…

Spree 5.2 lays the groundwork for several major upcoming improvements, including:

• New flexible Pricing engine, which can power subscriptions, B2B or regional pricing
• New Events engine allowing you to connect and extend Spree with Subscribers
• New Metafield Types allowing you to create relations between models, eg. related products
• Finally, a brand new, easy, and much faster API with SDKs

Stay tuned — Spree 5.3 and beyond will continue to push the platform forward.

👏 Contributors

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

• @nerijunior made their first contribution in Fix custom_domain to accept composed TLDs e.g: .com.br #12946
• @kyryloliinyk made their first contribution in Fix | add missing :uk svg country icon. #12953
• @jawaria-sparksol made their first contribution in Feature(admin): Add payment state filter to orders page #12954
• @Cichorek made their first contribution in del: unused class #12986
• @umeshravani made their first contribution in Create razorpay.mdx #12998
• @rorimwema made their first contribution in Fix typo in authentication docs #13042
• @karolina-bronowicka made their first contribution in V-3239 Added Adyen integration instructions #13140
• @ahmedelsherif-osama made their first contribution in Fix/gift card transitions for multiple partial redemptions and final redemption #13153 #13176
• @coderliu made their first contribution in Doc: fix minor typo in quickstart.mdx #13222

🙌 Thanks for your ongoing feedback, contributions, and passion for open-source eCommerce.
Let’s keep building the future of commerce — together.

Full Changelog: v5.1.0...v5.2.0