Sales Channels
A sales channel represents a place where your products are sold — your main storefront, a mobile app, a wholesale portal, a marketplace, or a pop-up kiosk. Each product is explicitly assigned to the channels where it should be available.
This gives you precise control: a wholesale-only product only appears on the B2B storefront; a limited-edition item only appears on your main store.
The default channel
Every Medusa store starts with one sales channel: Default Sales Channel. If you only have one storefront, all your products are in this channel and you rarely need to think about it.
Creating a sales channel
Go to Settings → Sales Channels and click + Add sales channel.
| Field | Description |
|---|---|
| Name | A clear label — e.g. "Main Store", "Wholesale Portal", "Mobile App" |
| Description | Optional internal notes about what this channel is for |
| Is active | Inactive channels are not shown at checkout — useful for staging a new channel before launch |
Adding products to a channel
There are two ways:
From the product: Open a product, scroll to the Sales channels section in the product form, and check the channels it should appear in.
From the channel: Open the sales channel, click + Add products, and select from your catalogue.
When you add a product to a channel, its variants, pricing, and inventory are not duplicated — only the listing is made available in that channel. One product record serves all channels.
Removing a product from a channel
Open the sales channel, find the product in the list, and click Remove. The product remains in your catalogue and is still available in other channels — it just won't show up in this one.
Sales channels and regions
Sales channels do not directly set pricing or currencies — those are controlled by regions. However, your storefront code determines which channel to query based on the publishable API key, and the API key is scoped to specific sales channels.
This chain looks like:
Storefront publishable key → Sales channel → Products (filtered) + Region → Prices + Tax
If a product is not in the sales channel used by your storefront, it will not appear — even if it has the right pricing and region settings.
When you create new products, always check they are assigned to the correct sales channels before publishing. A product that is active but in no channel will not appear on any storefront.
Use cases
| Scenario | How to set up |
|---|---|
| Single storefront | One default channel, all products assigned to it |
| Main store + B2B portal | Two channels; wholesale-only products in B2B channel only |
| Main store + mobile app | Two channels; same products in both |
| Pilot programme | Create an inactive channel, add pilot products, activate when ready |