Skip to content

armgit / spree

Public Imported from GitHub
0

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.

Documentation edits made through Mintlify web editor

mintlify[bot]acd602e529df
diff --git a/docs/images/use-cases/multi-tenant/capabilities.jpg b/docs/images/use-cases/multi-tenant/capabilities.jpg
new file mode 100644
index 0000000000..2b24e475f2
Binary files /dev/null and b/docs/images/use-cases/multi-tenant/capabilities.jpg differ
diff --git a/docs/images/use-cases/multi-tenant/super-admins.jpg b/docs/images/use-cases/multi-tenant/super-admins.jpg
new file mode 100644
index 0000000000..d1e69931de
Binary files /dev/null and b/docs/images/use-cases/multi-tenant/super-admins.jpg differ
diff --git a/docs/images/use-cases/multi-tenant/tenants.jpg b/docs/images/use-cases/multi-tenant/tenants.jpg
new file mode 100644
index 0000000000..6d2e77c6e2
Binary files /dev/null and b/docs/images/use-cases/multi-tenant/tenants.jpg differ
diff --git a/docs/use-case/marketplace/capabilities.mdx b/docs/use-case/marketplace/capabilities.mdx
index 92328edf1e..9f52b64a4e 100644
--- a/docs/use-case/marketplace/capabilities.mdx
+++ b/docs/use-case/marketplace/capabilities.mdx
@@ -25,6 +25,8 @@ Here’s an overview of each user perspective:
- **Customer Service** - optional chat and AI bots, ticketing, and store credits for efficient customer support.
- **APIs for headless projects and programmatic operations** - full coverage for storefront, platform, and checkout to enable custom functionality and integrations.
+See [Marketplace Admin Panel](https://spreecommerce.org/docs/use-case/marketplace/admin-dashboard) for a more detailed breakdown.
+
### Vendor Capabilities
![](/docs/images/use-cases/multi-vendor/vendor.png)
@@ -36,6 +38,8 @@ Here’s an overview of each user perspective:
- **Automated WooCommerce Onboarding & Operations** - syncs products, orders, shipments, cancellations, and refunds automatically between WooCommerce and the marketplace.
- **Vendor Payouts & Reporting** - automated or manual payouts, Stripe KYC onboarding, financial dashboards, and optional accounting integrations.
+See [Marketplace Vendor Panel](https://spreecommerce.org/docs/use-case/marketplace/vendor-dashboard) for a more detailed breakdown.
+
### Customer Experience
![](/docs/images/use-cases/multi-vendor/customer.png)
@@ -47,6 +51,8 @@ Here’s an overview of each user perspective:
- **Express Checkout & Payment Options** - including Apple Pay, Google Pay, installment plans, and payment links for quick, flexible checkout.
- **Notifications & Shipment Tracking** - send per-vendor email updates and provides a unified order view in the customer dashboard.
+See [Marketplace Customer Experience](https://spreecommerce.org/docs/use-case/marketplace/customer-ux) for a more detailed breakdown.
+
## Marketplace Scenarios
Spree’s modular architecture supports a variety of advanced marketplace models beyond the standard vendor-customer setup, enabling tailored experiences for specific business needs:
@@ -111,10 +117,10 @@ With Spree Enterprise, you’re not locked into a black-box SaaS model. You reta
## 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">
See Enterprise pricing for your use case
</Card>
</Columns>
\ No newline at end of file
diff --git a/docs/use-case/multi-tenant/franchises-and-reseller-networks.mdx b/docs/use-case/multi-tenant/franchises-and-reseller-networks.mdx
index 930fa7081c..f7a1dd4ac5 100644
--- a/docs/use-case/multi-tenant/franchises-and-reseller-networks.mdx
+++ b/docs/use-case/multi-tenant/franchises-and-reseller-networks.mdx
@@ -54,7 +54,7 @@ Manufacturers provide resellers with pre-configured online stores featuring cura
- **ERP Integration** - Sync catalog, inventory, and orders with enterprise resource planning systems for streamlined fulfillment.
- **Policy Enforcement** - Set global privacy policies, terms, and return policies applied uniformly across all stores.
- **Customer Service Control** - Parent company manages customer inquiries, returns, and refunds centrally.
-- **Theme Contro**l - Offer pre-approved storefront themes for franchisees/resellers with limited customization (e.g., logo upload, banner updates).
+- **Theme Control** - Offer pre-approved storefront themes for franchisees/resellers with limited customization (e.g., logo upload, banner updates).
### Reseller/Franchisee Capabilities
diff --git a/docs/use-case/multi-tenant/multi-brand-enterprise-model.mdx b/docs/use-case/multi-tenant/multi-brand-enterprise-model.mdx
index 28ce5c9bb2..886f464b29 100644
--- a/docs/use-case/multi-tenant/multi-brand-enterprise-model.mdx
+++ b/docs/use-case/multi-tenant/multi-brand-enterprise-model.mdx
@@ -21,19 +21,22 @@ Unlike marketplaces or SaaS commerce platforms:
This model is ideal for:
-- Global brands with **region-specific stores** (e.g., [us.brand.com](http://us.brand.com), [uk.brand.com](http://uk.brand.com), [au.brand.com](http://au.brand.com)) where each region needs full autonomy.
+- Global brands with **region-specific stores** (e.g., us.brand.com, uk.brand.com, au.brand.com) where each region needs full autonomy.
- Multi-brand groups managing **entirely distinct businesses** under one parent company (e.g., a fashion house owning separate luxury and lifestyle brands).
## Why Choose a Multi-Brand Architecture?
**Consistent yet autonomous**
+
- Maintain a unified technical stack and design system while allowing each brand to operate independently with unique catalogs, teams, and workflows.
-
+
**Operational efficiency**
+
- Reduce duplicated efforts by sharing infrastructure, integrations, and updates across all brands.
- Centralized governance for compliance, security, and performance monitoring.
**Full control & ownership**
+
- No reliance on external platforms or SaaS providers.
- Complete flexibility to customize every layer of the platform as business needs evolve.
@@ -93,13 +96,13 @@ With Spree, enterprises maintain complete ownership over their platform:
<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
+
- [<u>Multi-Tenant Model</u>](https://spreecommerce.org/docs/use-case/multi-tenant-platform/multi-tenant-model)
- [<u>Multi-Tenant Capabilities</u>](https://spreecommerce.org/docs/use-case/multi-tenant-platform/multi-tenant-capabilities)
- [<u>Super Admin Capabilities</u>](https://spreecommerce.org/docs/use-case/multi-tenant-platform/super-admin-capabilities)
diff --git a/docs/use-case/multi-tenant/multi-tenant-capabilities.mdx b/docs/use-case/multi-tenant/multi-tenant-capabilities.mdx
index b24efde0bc..3fa1b7ab86 100644
--- a/docs/use-case/multi-tenant/multi-tenant-capabilities.mdx
+++ b/docs/use-case/multi-tenant/multi-tenant-capabilities.mdx
@@ -3,13 +3,15 @@ title: "Multi-Tenant Capabilities"
description: "Learn how Spree Enterprise Edition supports multi-tenant ecommerce use cases."
---
+![](/docs/images/use-cases/multi-tenant/capabilities.jpg)
+
Spree Commerce Enterprise Edition provides a robust, API-first foundation for building multi-tenant platforms. 
While core features like tenant isolation and centralized management are universally useful and inherent to the architecture, Spree’s flexibility allows businesses to develop advanced multi-tenant capabilities unique to their own use case.
Whether you’re envisioning a tightly controlled network where the platform owner manages the branding, storefront look & feel, product catalog, payments, shipping, and customer service, or a hands-off model where tenants operate with full autonomy, Spree empowers you to tailor the experience. 
-<note>Some of the use-case-specific features described below would require some development effort on top of the existing multi-tenant platform.</note>
+Some of the use-case-specific features described below would require some development effort on top of the existing multi-tenant platform.
## Super Admin Capabilities
@@ -28,6 +30,8 @@ Whether you prefer a tightly managed network, (e.g., controlling the tenant stor
- **Branding & White-Label Tools** - Customize admin UI, emails, and storefronts for a fully white-labeled SaaS experience.
- **API Management** - Issue API keys for tenant-level integrations and control access scopes.
+See [Super Admin Capabilities](https://spreecommerce.org/docs/use-case/multi-tenant/super-admin-capabilities) for a more detailed breakdown.
+
## Tenant Capabilities
Tenants on a multi-tenant platform benefit from an intuitive and fully isolated environment to run their businesses. With Spree, each tenant can manage their own storefront, products, orders, customers, and configurations - all without affecting other tenants. 
@@ -45,6 +49,8 @@ Whether operating with complete autonomy or within limits defined by the super a
- **Customer Management** - Handle customer accounts, returns & refunds, and marketing communications independently.
- **Promotions & Discounts** - Create tenant-specific campaigns, coupon codes, and loyalty offers.
+See [Tenant Capabilities](https://spreecommerce.org/docs/use-case/multi-tenant/tenant-capabilities) for a more detailed breakdown.
+
## Customer Experience
For customers, a multi-tenant platform built on Spree delivers a seamless and familiar shopping journey, whether they’re exploring a single store or moving between multiple storefronts.
@@ -56,15 +62,14 @@ This consistency is especially vital for multi-brand enterprises looking to cros
- **Flexible Checkout** - Customers experience tenant-specific payment options, shipping methods, and policies.
- **Express Checkout & Payment Options** - including Apple Pay, Google Pay, installment plans, and payment links for quick, flexible checkout.
- **Notifications & Shipment Tracking** - send per-vendor email updates and provides a unified order view in the customer dashboard.
--
## Multi-Tenant Scenarios
No two multi-tenant platforms are alike, but they may share similar features and characteristics. Here are a few examples of general multi-tenant use cases:
-- **White-Label SaaS Commerce** - Offer merchants the tools to launch fully independent stores on your platform.
-- **Franchise & Dealer Networks** - Centralize brand control while allowing franchisees partial autonomy.
-- **Multi-Brand Enterprises** - Operate multiple brand storefronts under a unified backend.
+- [**White-Label SaaS Commerce**](https://spreecommerce.org/docs/use-case/multi-tenant/white-label-saas) - Offer merchants the tools to launch fully independent stores on your platform.
+- [**Franchise & Reseller Networks**](https://spreecommerce.org/docs/use-case/multi-tenant/franchises-and-reseller-networks) - Centralize brand control while allowing franchisees partial autonomy.
+- [**Multi-Brand Enterprises**](https://spreecommerce.org/docs/use-case/multi-tenant/multi-brand-enterprise-model) - Operate multiple brand storefronts under a unified backend.
- **Pop-Up & Event Commerce** - Support temporary tenant stores for events and seasonal campaigns.
## Flexible, Customizable Architecture
@@ -109,13 +114,13 @@ With Spree Enterprise, you’re not locked into a black-box SaaS model. You reta
<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
+
- [<u>Multi-Tenant Model</u>](https://spreecommerce.org/docs/use-case/multi-tenant-platform/multi-tenant-model)
- [<u>Super Admin Capabilities</u>](https://spreecommerce.org/docs/use-case/multi-tenant-platform/super-admin-capabilities)
- [<u>Tenant Capabilities</u>](https://spreecommerce.org/docs/use-case/multi-tenant-platform/tenant-capabilities)
diff --git a/docs/use-case/multi-tenant/super-admin-capabilities.mdx b/docs/use-case/multi-tenant/super-admin-capabilities.mdx
index 0305521159..c647773be2 100644
--- a/docs/use-case/multi-tenant/super-admin-capabilities.mdx
+++ b/docs/use-case/multi-tenant/super-admin-capabilities.mdx
@@ -3,6 +3,8 @@ title: "Super Admin Capabilities"
description: "Learn how super admins can manage multi-tenant platforms in Spree Enterprise Edition."
---
+![](/docs/images/use-cases/multi-tenant/super-admins.jpg)
+
Spree Commerce Enterprise Edition gives super admins complete flexibility in managing a multi-tenant platform. When operating such a platform, there are a range of models possible that sit along a “control spectrum” from full centralization (where the super admin manages everything) to full tenant autonomy (where tenants have complete operational control). This flexibility allows you to tailor the platform to your business model and tenant needs.
The features described below highlight examples from both ends of the “control spectrum.” Please note that some use-case-specific features may require additional development on top of the existing multi-tenant platform.
diff --git a/docs/use-case/multi-tenant/tenant-capabilities.mdx b/docs/use-case/multi-tenant/tenant-capabilities.mdx
index f1a652f8f7..0989427066 100644
--- a/docs/use-case/multi-tenant/tenant-capabilities.mdx
+++ b/docs/use-case/multi-tenant/tenant-capabilities.mdx
@@ -3,6 +3,8 @@ title: "Tenant Capabilities"
description: "Learn how tenants can manage their stores in Spree Enterprise Edition."
---
+![](/docs/images/use-cases/multi-tenant/tenants.jpg)
+
Spree Commerce Enterprise Edition provides tenants with a robust set of tools to manage every aspect of their stores. From catalog management and order fulfillment to branding and analytics, tenants enjoy full control over their ecommerce operations - subject to super admin policies and platform configurations.
## Tenant Dashboard 
diff --git a/docs/use-case/multi-tenant/white-label-saas.mdx b/docs/use-case/multi-tenant/white-label-saas.mdx
index a774b4d177..512fa346e7 100644
--- a/docs/use-case/multi-tenant/white-label-saas.mdx
+++ b/docs/use-case/multi-tenant/white-label-saas.mdx
@@ -3,7 +3,7 @@ title: "White-Label SaaS Platforms"
description: "Learn how to build white-label SaaS platforms with Spree Enterprise Edition."
---
-Spree Commerce Enterprise enables businesses to build scalable, white-label SaaS ecommerce platforms where merchants (tenants) can independently launch, configure, and manage their online stores.
+Spree Commerce Enterprise enables businesses to build scalable, [white-label SaaS ecommerce platforms](https://spreecommerce.org/multi-tenant-white-label-ecommerce/) where merchants (tenants) can independently launch, configure, and manage their online stores.
This model empowers SaaS providers to deliver a turnkey ecommerce experience for their clients, offering full autonomy over store operations while maintaining a centralized backend for platform oversight, billing, and scaling.
@@ -82,13 +82,13 @@ Spree enables SaaS providers to focus on scaling their business while delivering
<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
+
- [<u>Multi-Tenant Model</u>](https://spreecommerce.org/docs/use-case/multi-tenant-platform/multi-tenant-model)
- [<u>Multi-Tenant Capabilities</u>](https://spreecommerce.org/docs/use-case/multi-tenant-platform/multi-tenant-capabilities)
- [<u>Super Admin Capabilities</u>](https://spreecommerce.org/docs/use-case/multi-tenant-platform/super-admin-capabilities)