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
Uploaded Sales Channels user doc (#14145)
jaburghes7e7e272ce854
diff --git a/docs/docs.json b/docs/docs.jsonindex 88d3f1ccf3..c1e07b4e15 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -852,6 +852,7 @@"user/settings/emails","user/settings/policies","user/settings/domains",+ "user/settings/sales-channels","user/settings/payments","user/settings/markets","user/settings/zones",diff --git a/docs/images/user/settings/sales-channels/1-sales-channels-overview.png b/docs/images/user/settings/sales-channels/1-sales-channels-overview.pngnew file mode 100644index 0000000000..ea6b06238fBinary files /dev/null and b/docs/images/user/settings/sales-channels/1-sales-channels-overview.png differdiff --git a/docs/images/user/settings/sales-channels/2-new-sales-channel.png b/docs/images/user/settings/sales-channels/2-new-sales-channel.pngnew file mode 100644index 0000000000..79e3e4a366Binary files /dev/null and b/docs/images/user/settings/sales-channels/2-new-sales-channel.png differdiff --git a/docs/images/user/settings/sales-channels/3-product-publishing-card.png b/docs/images/user/settings/sales-channels/3-product-publishing-card.pngnew file mode 100644index 0000000000..44ae423ea7Binary files /dev/null and b/docs/images/user/settings/sales-channels/3-product-publishing-card.png differdiff --git a/docs/images/user/settings/sales-channels/4-manage-channels.png b/docs/images/user/settings/sales-channels/4-manage-channels.pngnew file mode 100644index 0000000000..83d6ca0775Binary files /dev/null and b/docs/images/user/settings/sales-channels/4-manage-channels.png differdiff --git a/docs/images/user/settings/sales-channels/5-channel-scheduling.png b/docs/images/user/settings/sales-channels/5-channel-scheduling.pngnew file mode 100644index 0000000000..975604a115Binary files /dev/null and b/docs/images/user/settings/sales-channels/5-channel-scheduling.png differdiff --git a/docs/images/user/settings/sales-channels/6-orders-list-channel-column.png b/docs/images/user/settings/sales-channels/6-orders-list-channel-column.pngnew file mode 100644index 0000000000..beeb4443d7Binary files /dev/null and b/docs/images/user/settings/sales-channels/6-orders-list-channel-column.png differdiff --git a/docs/images/user/settings/sales-channels/7-order-details-channel.png b/docs/images/user/settings/sales-channels/7-order-details-channel.pngnew file mode 100644index 0000000000..7ac8c47975Binary files /dev/null and b/docs/images/user/settings/sales-channels/7-order-details-channel.png differdiff --git a/docs/user/settings/sales-channels.mdx b/docs/user/settings/sales-channels.mdxnew file mode 100644index 0000000000..4db75a10b7--- /dev/null+++ b/docs/user/settings/sales-channels.mdx@@ -0,0 +1,112 @@+---+title: "Sales Channels"+description: "Learn how to create and manage sales channels in Spree Commerce."+---++import { Since } from '/snippets/since.mdx';++<Since version="5.5" />++Sales channels let you run multiple distinct storefronts or selling contexts from a single Spree instance — each with its own product catalog, order attribution, and routing behaviour. A channel might represent a public-facing online store, a wholesale portal, a mobile app, a point-of-sale terminal, or a seasonal microsite.++When an order comes in through a given channel, Spree tags it automatically so you can filter, report, and route fulfilment by channel. Products can be assigned to one or more channels, giving you precise control over what each audience sees.++Common use cases include:++- **Online store + POS** — keep retail and in-person orders separate for reporting and fulfilment+- **B2C + B2B wholesale portal** — show different catalogues and pricing to different audiences from one backend+- **Marketplace or affiliate channel** — attribute orders to the source channel for commission tracking+- **Mobile app** — route mobile orders separately and track conversion independently+- **Seasonal microsite** — run a limited-time catalogue without affecting your main storefront++<Note>Developers connect a storefront or integration to a specific channel by passing the `X-Spree-Channel` header with the channel's code in API requests. See the [Spree API docs](https://spreecommerce.org/docs/api-reference/storefront) for details.</Note>++To manage sales channels, navigate to **Settings → Sales Channels** in the admin dashboard.++## Sales Channels Overview++++The Sales Channels table displays all configured channels with the following details:++- **Name** — the internal label for the channel (e.g., "Online Store", "Wholesale Portal")+- **Code** — the unique identifier used in API requests to attribute orders to this channel+- **Default** — indicates which channel is used when no channel is specified in a request+- **Active** — whether the channel is currently enabled++## Create a Sales Channel++To create a new channel, click **New Sales Channel** in the top-right corner.++++Fill in the following fields:++- **Name** — an internal label to identify this channel (e.g., "iOS App", "EU Wholesale")+- **Code** — a short, unique identifier used in API requests (e.g., `ios-app`, `eu-wholesale`). This cannot be changed after creation.+- **Active** — uncheck to disable this channel without deleting it+- **Default** — check to make this the fallback channel for orders placed without a channel header+- **Order Routing Strategy** — controls how orders placed through this channel are allocated to stock locations for fulfilment. Select from:+ - **Inherit from store** — uses the same routing strategy as the default channel+ - **Rules (ordered)** — sets up a rules-based strategy; the specific rules can be configured via code+ - **Legacy** — uses the original Spree fulfilment flow++Once you've filled in the details, click **Create** to save the new channel.++### Order Routing Strategy++Order routing determines which stock location fulfils an order when you have multiple warehouses or fulfilment points. When an order is placed, Spree evaluates the assigned strategy for that channel to decide where to source each shipment from.++Channels that serve different regions or customer types often benefit from dedicated routing rules — for example, routing wholesale orders to a separate warehouse, or ensuring a specific fulfilment centre handles all orders from a particular storefront.++When using the **Rules (ordered)** strategy, the following rules can be configured and arranged in priority order:++1. **Preferred location** — always attempts to fulfil from a specific, designated stock location first, regardless of stock levels at other locations+2. **Minimize stock locations** — tries to fulfil the entire order from as few stock locations as possible, reducing split shipments and simplifying fulfilment+3. **Default location** — falls back to a designated stock location when no other rule has been satisfied++<Note>Rule rankings within the Rules (ordered) strategy can be adjusted by a developer per channel. See the [<u>developer documentation</u>](https://spreecommerce.org/docs/developer/core-concepts/channels) for details.</Note>++## Products and Sales Channels++When a product is created, it is automatically assigned to the default channel only. Any additional channels must be assigned manually. This means products are not visible on non-default channels until explicitly added.++To manage which channels a product is available on, open the product in the editor and locate the **Publishing** card.++++Click **Manage** to add or remove the channels this product is assigned to.++++Once a channel is assigned, you can click on it in the Publishing card to configure its scheduling settings — including the start and end dates for when the product should be active on that channel.++++A product's availability per channel follows its publishing status:++- **Live** — visible and purchasable on that channel+- **Scheduled** — will become active automatically at the configured start date+- **Not available** — assigned to the channel but hidden from customers++This allows you to curate entirely different catalogues for different audiences — for example, showing a reduced range on a wholesale channel while keeping the full catalogue on the main storefront.++<Note>If creating products via the Admin API, the product will have no channels assigned unless a channel is explicitly set in the request.</Note>++## Orders and Sales Channels++Every order placed through a channel is automatically attributed to it, making it easy to track volume and manage fulfilment per channel without any manual tagging.++In the **Orders** list, a **Channel** column shows which channel each order came from at a glance. You can also use the **Channel** filter to narrow the list to a specific channel.++++Opening an individual order shows the channel attribution in the order summary panel at the bottom of the page.++++## Related++- [Spree Storefront API docs](https://spreecommerce.org/docs/api-reference/storefront)+- [<u>Markets</u>](https://spreecommerce.org/docs/user/settings/markets)+- [<u>Price Lists</u>](https://spreecommerce.org/docs/user/manage-products/price-lists)