Skip to main content

Sales Channels

In this document, you’ll learn about Sales Channels and how they can be used in Medusa.

The Sales Channels feature is currently in beta mode and guarded by a feature flag. To use Sales Channels either:

  1. Enable the Copy to Clipboard environment variable;
  2. Or enable the Copy to Clipboard key in the Medusa server's settings.

You can learn more about enabling it in the feature flags documentation.

Introduction

Sales Channels allow you to separate between the different channels you sell products in. For example, you can have a sales channel for your website and another for your mobile apps.

Sales Channels are associated with stores, products, carts, and orders: A store has a default sales channel; you can define which products are available in a sales channel; you can specify the sales channel of a cart; you can filter orders by sales channel.

Example Use Cases

The sales channel feature can be used in a variety of use cases including:

  • Implement a B2B Ecommerce Store.
  • Specifying different products for each channel you sell in.
  • Support Omnichannel in your ecommerce store.

SalesChannel Entity Overview

A sales channel is stored in the database as a SalesChannel entity. Some of its important attributes are:

  • Copy to Clipboard: The name of the sales channel.
  • Copy to Clipboard: A boolean value indicating of the Sales Channel is disabled or not.

Relations to Other Entities

Store

A store has a default sales channel. When you first run your Medusa server or seed your database, a default sales channel is created, if it doesn’t exist, and associated with the store.

The relation is implemented in the Store entity. You can access the default sales channel of a store by expanding the Copy to Clipboard relation and using Copy to Clipboard. You can also access the ID of the default sales channel using Copy to Clipboard.

Product

Products can be available in more than one sales channel. You can then filter products by a sales channel using the Storefront and Admin APIs.

The relation is implemented in the Product entity. You can access the sales channels a product is available in by expanding the Copy to Clipboard relation and using Copy to Clipboard.

Cart

When you create a cart, you can optionally specify the sales channel it belongs to. If you don’t set the sales channel, the store’s default sales channel will be associated with it.

A cart can belong to only one sales channel. Only products that belong to the same sales channel as the cart can be added to it.

The relation is implemented in the Cart entity. You can access the sales channel a cart is associated with by expanding the Copy to Clipboard relation and using Copy to Clipboard. You can also access the ID of the sales channel using Copy to Clipboard.

Order

Orders can optionally be associated with a sales channel. You can filter orders by a sales channel using the Storefront and Admin APIs.

The relation is implemented in the Order entity. You can access the sales channel an order is associated with by expanding the Copy to Clipboard relation and using Copy to Clipboard. You can also access the ID of the sales channel using Copy to Clipboard.


What’s Next