Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
Documentation edits made through Mintlify web editor
mintlify[bot]9beb25847aa8
diff --git a/docs/docs.json b/docs/docs.jsonindex a46e27e29b..8da03298a6 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -137,7 +137,6 @@{"group": "Upgrade Guides","pages": [- "developer/upgrades/5.1-to-5.2","developer/upgrades/5.0-to-5.1","developer/upgrades/4.10-to-5.0","developer/upgrades/4.9-to-4.10",@@ -867,6 +866,13 @@"pages": ["integrations/marketing/klaviyo"]+ },+ {+ "group": "SSO, MFA & Social Login",+ "pages": [+ "integrations/sso-mfa-social-login/admin-dashboard",+ "integrations/sso-mfa-social-login/storefront"+ ]}]},@@ -1018,6 +1024,14 @@"use-case/b2b/b2b-buyer-capabilities"]},+ {+ "group": "Digital Products",+ "pages": [+ "use-case/digital-products/model",+ "use-case/digital-products/capabilities",+ "use-case/digital-products/admin-capabilities"+ ]+ },{"group": "ChatGPT Integration","pages": [@@ -1031,7 +1045,7 @@"pages": ["use-case/multi-store/model","use-case/multi-store/capabilities",- "use-case/multi-tenant/admin-capabilities"+ "use-case/multi-store/admin-capabilities"]},{diff --git a/docs/integrations/integrations.mdx b/docs/integrations/integrations.mdxindex 621cb6eec6..7d4b2deea4 100644--- a/docs/integrations/integrations.mdx+++ b/docs/integrations/integrations.mdx@@ -36,3 +36,14 @@ description: "Learn how to connect your Spree Commerce store to third-party servKlaviyo is a marketing automation platform that allows you to send email campaigns to your customers.</Card></CardGroup>++## SSO, MFA & Social Login++<CardGroup>+ <Card title="SSO & MFA for the Admin Panel" href="/integrations/sso-mfa-social-login/admin-dashboard">+ Learn how to secure your Spree admin panel with SSO and MFA integration, using Microsoft Entra ID as an example.+ </Card>+ <Card title="SSO & Social Login for the Storefront" href="/integrations/sso-mfa-social-login/storefront">+ Enable customer-facing SSO and social login on your Spree storefront, using Microsoft Entra External ID as an example.+ </Card>+</CardGroup>diff --git a/docs/integrations/sso-mfa-social-login/admin-dashboard.mdx b/docs/integrations/sso-mfa-social-login/admin-dashboard.mdxnew file mode 100644index 0000000000..2078359fe4--- /dev/null+++ b/docs/integrations/sso-mfa-social-login/admin-dashboard.mdx@@ -0,0 +1,66 @@+---+title: "SSO and MFA for the Admin Panel"+sidebarTitle: "Admin SSO & MFA"+description: "Learn how to secure your Spree admin panel with SSO and MFA integration, using Microsoft Entra ID as an example."+---++Enterprise businesses require **Single Sign-On (SSO)** and **Multi-Factor Authentication (MFA)** to secure sensitive operations, maintain compliance, and simplify IT administration. For Spree Commerce, the **admin panel** is the heart of your business operations, which means securing access here is critical.++## SSO providers++There are many popular SSO providers, such as **Microsoft Entra ID**, **Okta**, **Ping Identity**, and **OneLogin**. Each provider may also offer multiple services under its ecosystem.++For example, Microsoft’s SSO ecosystem includes:++- **Entra ID (previously Azure Active Directory)** → secures your **Spree Commerce admin panel** for workforce users.+- **Entra External ID (previously Active Directory B2C)** → secures your **Spree storefront** for customer-facing apps, with support for social logins like Google and Facebook.++<Note>+ For the purposes of this article, we are using **Microsoft** as the example provider.+</Note>++## Why integrate SSO with MFA for the Admin Panel++- **Used by staff, merchants, and operators**+- **Integration with Entra ID** ensures employees can log in using their corporate credentials+- Benefits include:+ - Higher security+ - Regulatory compliance (SOC2, HIPAA, GDPR)+ - Simplified IT administration+ - Better user experience with SSO+- With Microsoft solutions, you can also enable **Multi-Factor Authentication (MFA)** or **passwordless options** (Windows Hello, FIDO2 keys) to further strengthen access security++## Get Started with SSO and MFA++Each SSO integration needs to be scoped individually. The integration plan depends on multiple factors, such as:++- **Required SSO provider**+ - Decide whether you’ll use Microsoft Entra ID, Okta, Ping Identity, OneLogin, or another vendor. Each provider offers different features, protocols, and integration options.+- **SSO provider settings**+ - Each provider has unique configuration details, such as OAuth endpoints, certificates, tenant IDs, and federation settings. You’ll need to gather these to complete integration.+- **Existing or planned Spree customizations**+ - Custom authentication flows, extended user models, or unique admin permissions may affect how SSO is integrated. These should be reviewed before implementation.+- **Spree and Ruby on Rails versions**+ - Compatibility matters. Integration strategies can differ depending on whether you’re on the latest Spree release and which Rails version your project runs on.+- **Use case: single tenant vs. multi-tenant**+ - Single-tenant stores usually need straightforward workforce SSO. Multi-tenant or SaaS-style deployments may require isolated tenant directories and more complex provisioning.+- **Identity governance requirements** (role-based access, just-in-time provisioning)+- **User lifecycle management** (provisioning/de-provisioning)+- **Security posture** (MFA enforcement, conditional access, passwordless policies)+- **Compliance certifications required** (ISO, SOC2, HIPAA, PCI DSS)+- **Traffic scale and performance** (concurrent users, global access, load balancing)+- **Disaster recovery and redundancy** (failover strategies)+- **Integration with third-party services** (analytics, CDPs, data warehouses)++<Info>+ Let's get in touch so we can scope your requirements and deliver this important integration for your project.+</Info>++<Columns cols={2}>+ <Card title="Book a Call" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">+ Schedule a call to explore the options and get your questions answered+ </Card>+ <Card title="Ask a Question" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">+ Send us a message and share your thoughts+ </Card>+</Columns>\ No newline at end of filediff --git a/docs/integrations/sso-mfa-social-login/storefront.mdx b/docs/integrations/sso-mfa-social-login/storefront.mdxnew file mode 100644index 0000000000..7a46a047a9--- /dev/null+++ b/docs/integrations/sso-mfa-social-login/storefront.mdx@@ -0,0 +1,65 @@+---+title: "SSO and Social Login for the Storefront"+sidebarTitle: "Storefront SSO & Social Login"+description: "Enable customer-facing SSO and social login on your Spree storefront, using Microsoft Entra External ID as an example."+---++Enterprise businesses benefit from offering **customer-facing SSO and social login** because it streamlines the shopping experience and improves conversions. Customers prefer using accounts they already trust instead of creating new ones.++## SSO providers++There are many popular SSO providers, such as **Microsoft Entra External ID**, **Auth0**, **Okta**, and **Ping Identity**. Each provider may offer several services with different target use cases.++For example, Microsoft’s SSO ecosystem includes:++- **Entra ID (previously Azure Active Directory)** → secures your **Spree Commerce admin panel** for workforce users.+- **Entra External ID (previously Active Directory B2C)** → secures your **Spree storefront** for customer-facing apps, with support for social logins like Google and Facebook.++<Note>+ For the purposes of this article, we are using **Microsoft** as the example provider.+</Note>++## Why integrate SSO and Social Login for the Storefront++- **Used by shoppers**+- Integration with **Entra External ID (B2C)** or other customer identity providers enables frictionless sign-ups and sign-ins+- Benefits include:+ - Reduced cart abandonment+ - Faster checkout+ - Higher conversion rates+- Supports **social login options**: Google, Facebook, Amazon, Apple ID, Microsoft++## Get Started with SSO and Social Login++Each storefront integration must be scoped individually. Consider the following:++- **Required SSO provider**+ - Choose from Microsoft Entra External ID, Auth0, Okta, Ping Identity, or others. Your decision depends on features, ecosystem compatibility, and scalability needs.+- **SSO provider settings, including identity providers**+ - Each SSO platform has unique configuration settings (OAuth endpoints, certificates, client IDs). If you want to enable social logins, you’ll also need to configure providers like Google, Facebook, or Apple.+- **Scope: social login only vs. SSO + social login**+ - Decide whether you only want to add social login on top of Spree’s existing authentication or fully replace it with a unified SSO + social login solution.+- **Existing or planned Spree customizations**+ - Customized signup flows, checkout flows, or customer segmentation logic may impact integration design. These need to be factored in during scoping.+- **Spree and Ruby on Rails versions**+ - Ensure compatibility with your Spree and Rails versions. Older projects may need adjustments to take advantage of newer identity management features.+- **Identity governance requirements** (segmentation, customer role-based access)+- **User lifecycle management** (account creation, deactivation, syncing)+- **Security posture** (MFA for customers, adaptive login, fraud detection)+- **Compliance certifications required** (GDPR, CCPA, PCI DSS)+- **Traffic scale and performance** (millions of customer accounts, peak season load)+- **Disaster recovery and redundancy** (failover, global availability zones)+- **Integration with third-party services** (marketing automation, CDPs, analytics, loyalty programs)++<Info>+ Let's get in touch so we can scope your requirements and deliver this important integration for your project.+</Info>++<Columns cols={2}>+ <Card title="Book a Call" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">+ Schedule a call to explore the options and get your questions answered+ </Card>+ <Card title="Ask a Question" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">+ Send us a message and share your thoughts+ </Card>+</Columns>\ No newline at end of filediff --git a/docs/use-case/b2b/b2b-capabilities.mdx b/docs/use-case/b2b/b2b-capabilities.mdxindex abb7257731..b0aa777d40 100644--- a/docs/use-case/b2b/b2b-capabilities.mdx+++ b/docs/use-case/b2b/b2b-capabilities.mdx@@ -40,6 +40,24 @@ Spree’s architecture allows you to tailor nearly every aspect of the B2B exper- Deploy flexible permission models and checkout behavior across customer segments or accounts.- Use Spree’s APIs to deliver custom buyer portals or back-office workflows within mobile apps or existing web apps.+## Flexible, Customizable Architecture++While many marketplace features are available out-of-the-box in Spree Enterprise, the open-source foundation means you can extend and tailor the platform to your exact business model - whether that means custom commission logic, ERP integrations, or unique checkout flows.++Spree Enterprise offers flexibility across all layers of the platform, from code-level customization to no-code configuration.++- **Customization (Custom Code)**+ - **Backend (Ruby on Rails)** - extend business logic, workflows, and integrations via Spree's modular architecture. See: [<u>Spree Developer Quickstart</u>](https://spreecommerce.org/docs/developer/getting-started/quickstart)+ - **Frontend Themes (HTML, CSS, JS)** - customize storefront layouts, styling, and interactivity to match your brand and UX goals. See: [<u>Storefront Customization</u>](https://spreecommerce.org/docs/developer/storefront/storefront)+- **Configuration (No-Code / Low-Code)**+ - **Store Settings** - configure store name, logo, contact details, and supported languages/currencies.+ - **Custom Domains & Code Snippets** - set up domains and inject scripts (e.g., Google Tag Manager, Hotjar) without code.+ - **Shipping & Tax** - define shipping zones, rates, and tax rules per market.+- **Theme Editor (No-Code / Low-Code)**+ - **Drag-and-Drop Editor** - create and rearrange content using pre-built modules.+ - **Modular Pages** - build landing pages, homepages, and campaign sections.+ - **Brand Asset Management** - upload logos, banners, and product imagery without developer input.+## Full Ownership And ControlWith Spree Enterprise, you’re not locked into a black-box SaaS model. You retain complete control over your infrastructure, data, and roadmap, enabling long-term flexibility, scalability, and compliance.@@ -54,6 +72,7 @@ With Spree Enterprise, you’re not locked into a black-box SaaS model. You reta- **Built for Scale** - Spree supports advanced architectures using load balancers, Redis caching, CDN layers (e.g., Cloudflare or Fastly).- **High Availability** - avoid downtime during peak sales periods or global rollouts with scalable infrastructure.- **Security Under Your Control**+ - **Data Encryption** - Protect sensitive data in transit and at rest using standard encryption protocols.- **Anti-DDoS & Rate Limiting** - configure your own network protections using preferred security services.- **Vulnerability Management** - patch quickly, audit dependencies, and apply security policies with no vendor bottlenecks.- **Compliance Ownership**diff --git a/docs/use-case/digital-products/admin-capabilities.mdx b/docs/use-case/digital-products/admin-capabilities.mdxnew file mode 100644index 0000000000..89243abbed--- /dev/null+++ b/docs/use-case/digital-products/admin-capabilities.mdx@@ -0,0 +1,72 @@+---+title: "Digital Products Admin Capabilities"+description: "Learn about the digital product features available in the Spree admin dashboard."+---++Spree Commerce provides robust tools for managing digital products, offering flexibility and control over how files are configured, delivered, and accessed. Whether you're selling standalone digital goods or bundling them with physical items, Spree helps you streamline digital product operations while maintaining security and customer satisfaction.++Below is a breakdown of the key capabilities available to store administrators.++## Flexible Product Configuration++- Configure any product to be digital-only, physical, or a hybrid (e.g., physical textbook with downloadable companion PDF).+- Attach digital files (PDFs, ZIPs, etc.) directly to the product variant or order.+- File management UI in the admin dashboard for uploading, replacing, and associating files.++## Download Access Management++- Set download link expiration (e.g., 3 days) and/or maximum number of downloads (e.g., 5 per order).+- Control when download links become available:+ - Immediately after payment+ - Manually after admin approval+ - Upon fulfillment or other triggers++## Shipping Step Bypass++- Assign a “Digital Delivery” shipping category to digital products.+- If a cart only contains digital items, the shipping step is skipped entirely for faster checkout.++## Automated Digital Delivery++- Send download links by email after order placement.+- Customers can also access downloads from their “My Account” dashboard after logging in.+- Admins can resend download emails or regenerate download links when needed.++## Order and Access Logs++- Track and manage:+ - Which files were downloaded+ - How many times+ - By whom (customer email/account)+- Useful for fraud prevention or usage auditing.++## Security and Permissions++- Files are stored securely and served via protected, time-limited download URLs.+- Non-public file access prevents direct linking or unauthorized downloads.++## Bundling & Promotions++- Bundle digital products with physical items or offer them as free gifts with purchase.+- Create promotions or discounts specific to digital goods.++## Custom Rules & Logic (Optional)++- Use Spree’s flexible architecture to create custom workflows, such as:+ - Requiring customer approval for certain file types+ - Generating personalized files (e.g., license keys or certificates)+ - Integrating with external file storage or DRM systems++## Get Started+<Columns cols={2}>+ <Card title="Book a Demo" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">+ Schedule a demo to explore the platform and get your questions answered+ </Card>+ <Card title="Ask for Pricing" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">+ See Enterprise pricing for your use case+ </Card>+</Columns>++## Further Reading+- [Digital Products Model](https://spreecommerce.org/docs/use-case/digital-products/model)+- [Digital Products Capabilities](https://spreecommerce.org/docs/use-case/digital-products/capabilities)diff --git a/docs/use-case/digital-products/capabilities.mdx b/docs/use-case/digital-products/capabilities.mdxnew file mode 100644index 0000000000..62c4c03e5d--- /dev/null+++ b/docs/use-case/digital-products/capabilities.mdx@@ -0,0 +1,81 @@+---+title: "Digital Products Capabilities"+description: "Learn about the digital product features available in Spree Commerce."+---++Spree Commerce gives merchants complete control over the sale and delivery of digital products. Whether you're selling fully digital goods or offering downloadable add-ons, Spree provides a flexible and secure framework for instant delivery, gated access, and hybrid product configurations.++## Admin Capabilities++Spree provides merchants with robust tools to manage digital products alongside physical inventory. Whether you're distributing eBooks, music files, software licenses, or digital assets, Spree allows you to configure flexible delivery rules, streamline access, and maintain full control over the digital fulfillment lifecycle.++- **Flexible Product Configuration** - Create fully digital products or attach digital files to physical products.+- **Download Access Management** - Define limits for how many times a file can be downloaded and for how long download links remain active.+- **Multiple Delivery Channels** - Offer download access directly on the confirmation page, in order emails, or via the customer's account area.+- **Digital-Only Checkout** - Assign digital SKUs to a “Digital” shipping category. When only digital items are in the cart, the delivery step is skipped to streamline the checkout flow.+- \*\*Link Control & Expiry - \*\*Set download permissions and expiry windows. Revoke access manually if needed to prevent abuse or for license changes.+- **Segmentation & Analytics** - Track digital product performance using Spree’s reporting tools. Segment buyers based on purchase behavior or file download activity.+- **Metafield Support** - Use metafields to attach structured metadata to digital products (e.g., license type, access level, product version). These can be queried for automation or integrations.++## Customer Experience++Spree makes buying and receiving digital products fast, intuitive, and secure. Customers enjoy instant access to downloads after purchase, without unnecessary friction or waiting. With options to retrieve files via email or their account dashboard, the experience is smooth and dependable - building trust and satisfaction with every order.++- **Instant Access Post-Purchase** - Download links can appear immediately after checkout and are also delivered via email or available in the user dashboard.+- **Frictionless Checkout Flow** - When purchasing only digital products, users skip shipping steps entirely, making checkout faster and more intuitive.+- **Secure & Transparent Downloads** - Customers see how many downloads remain and how long links are active. Links are secure and uniquely generated per order.+- **Ongoing Access via My Account** - Digital purchases remain available in the customer’s account (if enabled), allowing repeat access without needing to contact support.++## Flexible, Customizable Architecture++While many digital products features are available out-of-the-box in Spree Community Edition, the open-source foundation means you can extend and tailor the platform to your exact business model - whether that means custom commission logic, ERP integrations, or unique checkout flows.++Spree offers flexibility across all layers of the platform, from code-level customization to no-code configuration.++- **Customization (Custom Code)**+ - **Backend (Ruby on Rails)** - extend business logic, workflows, and integrations via Spree's modular architecture. See:[<u>Spree Developer Quickstart</u>](https://spreecommerce.org/docs/developer/getting-started/quickstart)+ - **Frontend Themes (HTML, CSS, JS)** - customize storefront layouts, styling, and interactivity to match your brand and UX goals. See:[<u>Storefront Customization</u>](https://spreecommerce.org/docs/developer/storefront/storefront)+- **Configuration (No-Code / Low-Code)**+ - **Store Settings** - configure store name, logo, contact details, and supported languages/currencies.+ - **Custom Domains & Code Snippets** - set up domains and inject scripts (e.g., Google Tag Manager, Hotjar) without code.+ - **Shipping & Tax** - define shipping zones, rates, and tax rules per market.+- **Theme Editor (No-Code / Low-Code)**+ - **Drag-and-Drop Editor** - create and rearrange content using pre-built modules.+ - **Modular Pages** - build landing pages, homepages, and campaign sections.+ - **Brand Asset Management** - upload logos, banners, and product imagery without developer input.++## Full Ownership And Control++With Spree, you’re not locked into a black-box SaaS model. You retain complete control over your infrastructure, data, and roadmap, enabling long-term flexibility, scalability, and compliance.++- **API-Driven Extensibility**+ - **Full API Coverage** - extend the platform via REST or GraphQL APIs for storefronts, checkout, vendor dashboards, or 3rd-party integrations. See:[<u>API Reference</u>](https://spreecommerce.org/docs/api-reference/introduction)+ - **Custom Integrations** - seamlessly connect with ERPs, CRMs, payment providers, POS systems, or headless frontends.+- **Deployment Flexibility**+ - **Self-Hosting Options** - deploy Spree anywhere; your cloud provider, on-premise, or in specific geographic regions. See:[<u>Deployment Guide</u>](https://spreecommerce.org/docs/developer/deployment/render)+ - **Provider Agnostic** - run on AWS, GCP, Azure, or Render. Tailor infrastructure to budget, compliance, and performance needs.+- **Scalability & Performance**+ - **Built for Scale** - Spree supports advanced architectures using load balancers, Redis caching, CDN layers (e.g., Cloudflare or Fastly).+ - **High Availability** - avoid downtime during peak sales periods or global rollouts with scalable infrastructure.+- **Security Under Your Control, included in the Enterprise Edition**+ - **Data Encryption** - Protect sensitive data in transit and at rest using standard encryption protocols.+ - **Anti-DDoS & Rate Limiting** - configure your own network protections using preferred security services.+ - **Vulnerability Management** - patch quickly, audit dependencies, and apply security policies with no vendor bottlenecks.+- **Compliance Ownership**+ - **Full Compliance Control** - build to meet your exact regulatory requirements, whether WCAG, GDPR, HIPAA, or SOC2.+ - **Data Sovereignty** - keep data within borders required by your industry or region.++## Get Started+<Columns cols={2}>+ <Card title="Book a Demo" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">+ Schedule a demo to explore the platform and get your questions answered+ </Card>+ <Card title="Ask for Pricing" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">+ See Enterprise pricing for your use case+ </Card>+</Columns>+++## Further Reading+- [Digital Products Model](https://spreecommerce.org/docs/use-case/digital-products/model)+- [Digital Products Admin Capabilities](https://spreecommerce.org/docs/use-case/digital-products/admin-capabilities)\ No newline at end of filediff --git a/docs/use-case/digital-products/model.mdx b/docs/use-case/digital-products/model.mdxnew file mode 100644index 0000000000..409e0cdc4f--- /dev/null+++ b/docs/use-case/digital-products/model.mdx@@ -0,0 +1,78 @@+---+title: "Digital Products Model"+description: "Learn about the digital product ecommerce model with Spree Commerce."+---++Spree Commerce provides support for businesses selling digital goods whether you're offering downloadable files, access codes, subscriptions, or mixed-format products with both physical and digital components.++With Spree, you can streamline the delivery of digital content, enforce access rules, and provide a seamless experience from purchase to download, all while retaining full ownership and control over the customer journey.++<Columns cols={2}>+ <Card title="Book a Demo" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">+ Schedule a demo to explore the platform and get your questions answered+ </Card>+ <Card title="Ask for Pricing" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">+ See Enterprise pricing for your use case+ </Card>+</Columns>++## What is Digital Product Commerce?++Digital product commerce refers to the sale and delivery of intangible goods online, i.e., items that don't require physical shipping. These can include:++- Ebooks, PDFs, music files, videos, or artwork+- Software licenses or activation keys+- Educational materials or course access+- Downloadable templates or design assets+- Digital components of a physical product (e.g., user manuals, bonus media)++Unlike traditional ecommerce, there’s no inventory to manage or shipping to coordinate, but there are unique considerations around access, licensing, delivery, and customer experience.++## Why Choose a Digital Product Model?++- **Instant Delivery & Global Reach** - Digital products are available immediately after purchase, enabling frictionless fulfillment and zero logistics overhead.+- **Operational Efficiency** - No warehousing, shipping, or returns processing, just secure file hosting and access management.+- **Flexible Product Structures** - Bundle digital goods with physical items, sell standalone files, or combine multiple digital assets in a single SKU.+- **Controlled Access** - Use built-in rules to limit downloads per customer, expire links after a period, and ensure compliance with usage restrictions.++## Common Digital Product Use Cases++- **Digital Downloads Only** - audio files, software, or ebooks sold directly through an online store.+- **Digital + Physical Bundles** - e.g., selling a hardcover book that includes a free digital PDF version.+- **Membership or Subscription Access** - gated digital content tied to recurring billing or customer groups.+- **Instructional Materials** - downloadable manuals, training resources, or product guides.+- **License-Based Sales** - activation codes, keys, or serial numbers delivered post-purchase.++## Challenges in Digital Product Ecommerce++- **Secure Delivery** - Preventing unauthorized sharing or reuse of download links.+- **Access Control** - Offering flexible but enforceable download limits (time-based or usage-based).+- **Mixed Cart Handling** - Managing checkout experiences when carts contain both digital and physical items.+- **Content Updates** - Ensuring buyers get access to the latest versions of digital products post-purchase.++## How Spree Supports Digital Products++Spree’s digital product system is designed to offer flexibility for a wide range of use cases while providing a smooth customer experience:++- **Fully Digital or Hybrid SKUs** - Attach digital files to any product—whether sold standalone or alongside physical goods.+- **Download Access Management** - Automatically provide access upon purchase via email, user dashboard, or both. Configure:+ - Link expiry (by time)+ - Download limits (by count)+ - Manual revocation or reactivation+- **Digital Shipping Category** - If a product is marked as “digital only,” the checkout flow automatically skips the shipping step, reducing friction and improving speed to delivery.+- **My Account Access** - Customers can retrieve purchased files anytime from their “My Account” dashboard, based on the access settings you configure.+- **Flexible Delivery Methods** - Whether you want to show the download link on the success page, in an email, or via account login only, Spree gives you control over how digital content is distributed.++## Get Started+<Columns cols={2}>+ <Card title="Book a Demo" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">+ Schedule a demo to explore the platform and get your questions answered+ </Card>+ <Card title="Ask for Pricing" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">+ See Enterprise pricing for your use case+ </Card>+</Columns>++## Further Reading+- [Digital Products Capabilities](https://spreecommerce.org/docs/use-case/digital-products/capabilities)+- [Digital Products Admin Capabilities](https://spreecommerce.org/docs/use-case/digital-products/admin-capabilities)diff --git a/docs/use-case/marketplace/capabilities.mdx b/docs/use-case/marketplace/capabilities.mdxindex 9f52b64a4e..da9c2a111d 100644--- a/docs/use-case/marketplace/capabilities.mdx+++ b/docs/use-case/marketplace/capabilities.mdx@@ -100,6 +100,7 @@ With Spree Enterprise, you’re not locked into a black-box SaaS model. You reta- **Built for Scale** - Spree supports advanced architectures using load balancers, Redis caching, CDN layers (e.g., Cloudflare or Fastly).- **High Availability** - avoid downtime during peak sales periods or global rollouts with scalable infrastructure.- **Security Under Your Control**+ - **Data Encryption** - Protect sensitive data in transit and at rest using standard encryption protocols.- **Anti-DDoS & Rate Limiting** - configure your own network protections using preferred security services.- **Vulnerability Management** - patch quickly, audit dependencies, and apply security policies with no vendor bottlenecks.- **Compliance Ownership**diff --git a/docs/use-case/marketplace/model.mdx b/docs/use-case/marketplace/model.mdxindex b68a54d7b9..0f912624a8 100644--- a/docs/use-case/marketplace/model.mdx+++ b/docs/use-case/marketplace/model.mdx@@ -44,12 +44,6 @@ Launching a successful marketplace requires careful attention to:- **Vendor permissions** - ensuring appropriate access levels across the platform.- **Trust and quality control** - managing fulfillment, reviews, and customer service.-## Further Reading-- [Multi-vendor Marketplace Capabilities](https://spreecommerce.org/docs/use-case/marketplace/capabilities)-- [Admin UX](https://spreecommerce.org/docs/use-case/marketplace/admin-dashboard)-- [Vendor UX](https://spreecommerce.org/docs/use-case/marketplace/vendor-dashboard)-- [Customer UX](https://spreecommerce.org/docs/use-case/marketplace/customer-ux)-## Get Started<Columns cols={2}><Card title="Book a Demo" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">@@ -58,4 +52,10 @@ Launching a successful marketplace requires careful attention to:<Card title="Ask for Pricing" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">See Enterprise pricing for your use case</Card>-</Columns>\ No newline at end of file+</Columns>++## Further Reading+- [Multi-vendor Marketplace Capabilities](https://spreecommerce.org/docs/use-case/marketplace/capabilities)+- [Admin UX](https://spreecommerce.org/docs/use-case/marketplace/admin-dashboard)+- [Vendor UX](https://spreecommerce.org/docs/use-case/marketplace/vendor-dashboard)+- [Customer UX](https://spreecommerce.org/docs/use-case/marketplace/customer-ux)\ No newline at end of filediff --git a/docs/use-case/multi-store/capabilities.mdx b/docs/use-case/multi-store/capabilities.mdxindex e9efd58bb5..574fd75179 100644--- a/docs/use-case/multi-store/capabilities.mdx+++ b/docs/use-case/multi-store/capabilities.mdx@@ -13,7 +13,7 @@ Spree gives store operators the flexibility to manage multiple storefronts from- **Easy setup** - provision new stores instantly via the dashboard, each with its own custom domain and branding.- **Cross-store sharing** - choose what to share between your stores.-- \*\*Store-specific payment gateways - \*\*support localized payment methods or region-specific accounts.+- **Store-specific payment gateways** - support localized payment methods or region-specific accounts.- **Per-store inventory visibility** - allow a product to appear in one store but not another.- **Admin user permissions** - control access per store or across all stores.- **Customize themes and pages per store** - allows design freedom within a unified architecture.@@ -41,6 +41,24 @@ Depending on how the multi-store setup is used, businesses can apply different c- **Promotional Experimentation** - run different marketing strategies per store and compare performance centrally.- **Content Flexibility** - use store-specific blog content, landing pages, and campaigns for better audience alignment.+## Flexible, Customizable Architecture++While many multi-store features are available out-of-the-box in Spree Enterprise, the open-source foundation means you can extend and tailor the platform to your exact business model - whether that means custom commission logic, ERP integrations, or unique checkout flows.++Spree Enterprise offers flexibility across all layers of the platform, from code-level customization to no-code configuration.++- **Customization (Custom Code)**+ - **Backend (Ruby on Rails)** - extend business logic, workflows, and integrations via Spree's modular architecture. See: [<u>Spree Developer Quickstart</u>](https://spreecommerce.org/docs/developer/getting-started/quickstart)+ - **Frontend Themes (HTML, CSS, JS)** - customize storefront layouts, styling, and interactivity to match your brand and UX goals. See: [<u>Storefront Customization</u>](https://spreecommerce.org/docs/developer/storefront/storefront)+- **Configuration (No-Code / Low-Code)**+ - **Store Settings** - configure store name, logo, contact details, and supported languages/currencies.+ - **Custom Domains & Code Snippets** - set up domains and inject scripts (e.g., Google Tag Manager, Hotjar) without code.+ - **Shipping & Tax** - define shipping zones, rates, and tax rules per market.+- **Theme Editor (No-Code / Low-Code)**+ - **Drag-and-Drop Editor** - create and rearrange content using pre-built modules.+ - **Modular Pages** - build landing pages, homepages, and campaign sections.+ - **Brand Asset Management** - upload logos, banners, and product imagery without developer input.+## Full Ownership And ControlWith Spree Enterprise, you’re not locked into a black-box SaaS model. You retain complete control over your infrastructure, data, and roadmap, enabling long-term flexibility, scalability, and compliance.@@ -55,6 +73,7 @@ With Spree Enterprise, you’re not locked into a black-box SaaS model. You reta- **Built for Scale** - Spree supports advanced architectures using load balancers, Redis caching, CDN layers (e.g., Cloudflare or Fastly).- **High Availability** - avoid downtime during peak sales periods or global rollouts with scalable infrastructure.- **Security Under Your Control**+ - **Data Encryption** - Protect sensitive data in transit and at rest using standard encryption protocols.- **Anti-DDoS & Rate Limiting** - configure your own network protections using preferred security services.- **Vulnerability Management** - patch quickly, audit dependencies, and apply security policies with no vendor bottlenecks.- **Compliance Ownership**@@ -73,5 +92,6 @@ With Spree Enterprise, you’re not locked into a black-box SaaS model. You reta</Columns>## Further Reading+- [<u>Multi-Store Model</u>](https://spreecommerce.org/docs/use-case/multi-store/model)- [<u>Multi-Store Admin Capabilities</u>](https://spreecommerce.org/docs/use-case/multi-store/admin-capabilities)\ No newline at end of filediff --git a/docs/use-case/multi-tenant/multi-tenant-capabilities.mdx b/docs/use-case/multi-tenant/multi-tenant-capabilities.mdxindex cfbb6bc5d0..a07d0b5792 100644--- a/docs/use-case/multi-tenant/multi-tenant-capabilities.mdx+++ b/docs/use-case/multi-tenant/multi-tenant-capabilities.mdx@@ -104,6 +104,7 @@ With Spree Enterprise, you’re not locked into a black-box SaaS model. You reta- **Built for Scale** - Spree supports advanced architectures using load balancers, Redis caching, CDN layers (e.g., Cloudflare or Fastly).- **High Availability** - avoid downtime during peak sales periods or global rollouts with scalable infrastructure.- **Security Under Your Control**+ - **Data Encryption** - Protect sensitive data in transit and at rest using standard encryption protocols.- **Anti-DDoS & Rate Limiting** - configure your own network protections using preferred security services.- **Vulnerability Management** - patch quickly, audit dependencies, and apply security policies with no vendor bottlenecks.- **Compliance Ownership**diff --git a/docs/use-case/overview.mdx b/docs/use-case/overview.mdxindex 160d9511cf..b0923cb6e8 100644--- a/docs/use-case/overview.mdx+++ b/docs/use-case/overview.mdx@@ -5,7 +5,7 @@ description: "Launch marketplaces, SaaS, and B2B platforms faster with Spree."Spree Commerce [Enterprise Edition](https://spreecommerce.org/docs/user/what-is-spree-commerce#community-edition-vs-enterprise-edition) significantly reduces your time to market and lowers the total cost of ownership for ecommerce platforms across a variety of business models, including:-<Card title="Multi-vendor Marketplace" icon="cart-plus" href="https://spreecommerce.org/docs/use-case/marketplace/capabilities" cta="Learn more">+<Card title="Multi-Vendor Marketplace" icon="cart-plus" href="https://spreecommerce.org/docs/use-case/marketplace/capabilities" cta="Learn more">A multi-vendor marketplace platform enables multiple third-party vendors to sell products via your storefront, allowing customers to buy from various vendors in one transaction.</Card>@@ -17,11 +17,23 @@ Spree Commerce [Enterprise Edition](https://spreecommerce.org/docs/user/what-is-Streamline and automate your B2B ecommerce operations, enhancing customer relationships and sales efficiency.</Card>+<Card title="Multi-Store Platform" icon="people-roof" href="https://spreecommerce.org/docs/use-case/multi-tenant/multi-tenant-capabilities" cta="Learn more">+ Run multiple storefronts from a single backend, each with custom domains, catalogs, and configurations, while sharing infrastructure and admin controls.+</Card>++<Card title="ChatGPT Integration" icon="people-roof" href="https://spreecommerce.org/docs/use-case/multi-tenant/multi-tenant-capabilities" cta="Learn more">+ Convert product discovery into instant sales by enabling checkout directly within ChatGPT conversations using the Agentic Commerce Protocol.+</Card>++<Card title="Digital Products" icon="people-roof" href="https://spreecommerce.org/docs/use-case/multi-tenant/multi-tenant-capabilities" cta="Learn more">+ Sell and deliver digital goods with flexible configuration, automated download management, and access control.+</Card>+<Columns cols={2}>- <Card title="Book a Demo" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">+ <Card title="Book a Demo" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">Schedule a demo to explore the platform and get your questions answered</Card>- <Card title="Ask for Pricing" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">+ <Card title="Ask for Pricing" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">Ask for Enterprise Edition pricing for the Use Case of your choice.</Card></Columns>@@ -64,6 +76,24 @@ Learn more about the full list of [multi-vendor marketplace capabilities](https:- Seamless integrations with ERP, CRM, and inventory management systems- Flexible business model expansion through dropshipping and multiple warehouses+#### [Multi-Store Platform](https://spreecommerce.org/docs/use-case/multi-store/capabilities)++- Spin up new storefronts instantly with customizable domains, themes, and configurations+- Share customers, products, and payment methods across stores while isolating orders and content+- Centralize operations with a single admin dashboard controlling multiple stores++#### [ChatGPT Integration](https://spreecommerce.org/docs/use-case/chatgpt-integration/chatgpt-instant-checkout)++- Reach intent-driven buyers directly through ChatGPT product recommendations+- Enable seamless purchases with Stripe-powered Instant Checkout in the conversation+- Maintain full control over fulfillment, returns, and customer relationships++#### [Digital Products](https://spreecommerce.org/docs/use-case/digital-products/capabilities)++- Sell digital goods alongside physical products or standalone+- Automate delivery through email, “My Account”, or instant download+- Control access with expiration dates, download limits, and digital-only checkout flows+### Looking for User Docs?Feel free to use detailed Spree Commerce [User Documentation](https://spreecommerce.org/docs/user/what-is-spree-commerce), including getting started guides, feature explainers, and step-by-step how-to instructions for daily eCommerce operations.@@ -74,19 +104,19 @@ If you are a Spree developer, you may find the [**Developer Docs**](https://spreBTW Give Spree a [GitHub Star](https://github.com/spree/spree)<Icon icon="star" iconType="solid" color="#FFD43B" />, why dont't ya?-Thank you for supporting Spree open-source\! <Icon icon="heart" iconType="solid" color="#FF0000" />+Thank you for supporting Spree open-source! <Icon icon="heart" iconType="solid" color="#FF0000" />## Join Spree Slack-To join the Spree Community and over 6000\+ Spree users and developers, please sign up for Spree Slack channels here: https://slack.spreecommerce.org/+To join the Spree Community and over 6000+ Spree users and developers, please sign up for Spree Slack channels here: https://slack.spreecommerce.org/## Get Started<Columns cols={2}>- <Card title="Book a Demo" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">+ <Card title="Book a Demo" icon="eye" href="https://getvendo.com/book-a-demo/" cta="Click here">Schedule a demo to explore the platform and get your questions answered</Card>- <Card title="Ask for Pricing" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">+ <Card title="Ask for Pricing" icon="dollar-sign" href="https://spreecommerce.org/get-started/" cta="Click here">Ask for Enterprise Edition pricing for the Use Case of your choice.</Card></Columns>\ No newline at end of file