Saleor Channels
Before writing code
Fetch live docs:
- Fetch
https://docs.saleor.io/developer/channels/overview for channels overview
- Web-search
site:docs.saleor.io channel configuration currency countries for channel setup reference
- Web-search
site:docs.saleor.io per-channel pricing product for channel-aware pricing
- Web-search
site:docs.saleor.io warehouse allocation channels for warehouse-channel mapping
- Web-search
site:docs.saleor.io multi-brand multi-tenant channels for multi-brand patterns
Channel Concept
A channel represents a distinct sales context within a single Saleor instance. One Saleor deployment can serve multiple storefronts, regions, brands, or business models -- each as a separate channel.
| Aspect |
Detail |
| One instance |
Single Saleor backend, shared catalog and infrastructure |
| Many channels |
Each channel has its own currency, countries, pricing, and settings |
| Isolation |
Customers see only channel-scoped data (prices, availability) |
| Staff access |
Staff can manage all channels from one Dashboard |
Channel Configuration Fields
| Field |
Type |
Purpose |
name |
string |
Human-readable channel name |
slug |
string |
URL-safe identifier (used in API queries) |
currencyCode |
string |
ISO 4217 currency code (e.g., USD, EUR, GBP) |
defaultCountry |
string |
ISO 3166-1 alpha-2 country code |
countries |
string[] |
Countries where this channel operates |
isActive |
boolean |
Whether the channel is publicly accessible |
stockSettings.allocationStrategy |
enum |
PRIORITIZE_HIGH_STOCK or PRIORITIZE_SORTING_ORDER |
orderSettings.automaticallyConfirmAllNewOrders |
boolean |
Auto-confirm orders |
orderSettings.automaticallyFulfillNonShippableGiftCard |
boolean |
Auto-fulfill digital gift cards |
checkoutSettings.useLegacyErrorFlow |
boolean |
Legacy vs new error handling |
Per-Channel Pricing
Products have base prices, but each channel can define its own pricing:
| Pricing Layer |
Scope |
Purpose |
| Product variant price |
Per channel |
Base selling price in channel currency |
| Cost price |
Per channel |
Cost of goods for margin calculation |
| Channel currency |
Per channel |
All prices in this channel use this currency |
| Tax configuration |
Per channel |
Tax calculation rules |
| Discounts |
Per channel |
Promotions scoped to specific channels |
Pricing Assignment
| Entity |
Channel-Scoped Fields |
| Product variant |
channelListings.price, channelListings.costPrice |
| Product |
channelListings.isPublished, channelListings.publishedAt, channelListings.isAvailableForPurchase |
| Collection |
channelListings.isPublished, channelListings.publishedAt |
| Shipping method |
channelListings.price, channelListings.minimumOrderPrice, channelListings.maximumOrderPrice |
| Voucher |
channelListings.discountValue, channelListings.minSpent |
Country Assignment
Each channel defines a set of countries it serves:
| Aspect |
Detail |
| Shipping |
Only shipping methods for assigned countries are available |
| Tax |
Tax rules are applied based on channel country settings |
| Address validation |
Checkout validates against channel's country list |
| Warehouse selection |
Warehouses are linked to countries within channels |
Warehouse Allocation
Warehouses and channels are connected through country assignments:
| Concept |
Relationship |
| Warehouse |
Has a list of shipping zones it serves |
| Shipping zone |
Has a list of countries |
| Channel |
Has a list of countries |
| Allocation |
Saleor allocates stock from warehouses that serve the channel's countries |
Allocation Strategies
| Strategy |
Behavior |
PRIORITIZE_SORTING_ORDER |
Allocate from warehouses in their configured sort order (default) |
PRIORITIZE_HIGH_STOCK |
Allocate from the warehouse with the most stock |
Channel-Aware GraphQL Queries
Most storefront queries require a channel argument:
| Query |
Channel Behavior |
products(channel: "us") |
Returns products published in the US channel |
product(slug: "tee", channel: "us") |
Returns US-channel pricing and availability |
collections(channel: "us") |
Returns collections published in the US channel |
checkout(channel: "us") |
Creates checkout with US currency and settings |
shippingMethods(channel: "us") |
Returns methods available for US channel countries |
Queries without the channel argument are reserved for staff/admin operations and return data across all channels.
Channel Creation via GraphQL
| Mutation |
Purpose |
channelCreate |
Create a new channel with currency and country settings |
channelUpdate |
Modify channel settings (countries, stock strategy) |
channelDelete |
Remove a channel (irreversible) |
channelActivate |
Make a channel publicly accessible |
channelDeactivate |
Hide a channel from public access |
Channel Creation Fields
| Input Field |
Required |
Purpose |
name |
Yes |
Display name |
slug |
Yes |
URL-safe identifier |
currencyCode |
Yes |
Channel currency |
defaultCountry |
Yes |
Primary country |
addCountries |
No |
Additional countries |
stockSettings |
No |
Allocation strategy |
orderSettings |
No |
Auto-confirm, fulfillment rules |
Multi-Brand Architecture
Channels enable multi-brand commerce from a single Saleor instance:
| Brand |
Channel |
Storefront |
Currency |
| Brand A (US) |
brand-a-us |
brand-a.com |
USD |
| Brand A (EU) |
brand-a-eu |
brand-a.eu |
EUR |
| Brand B (US) |
brand-b-us |
brand-b.com |
USD |
| Wholesale |
wholesale |
wholesale.brand-a.com |
USD |
Multi-Brand Considerations
| Aspect |
Approach |
| Product catalog |
Shared catalog, per-channel publication and pricing |
| Customers |
Shared customer base across channels |
| Orders |
Each order belongs to one channel |
| Staff permissions |
Channel-level access control for staff members |
| Apps |
Apps can be channel-aware or cross-channel |
| Warehouses |
Shared warehouses, per-channel allocation |
Channel Permissions
| Permission |
Scope |
MANAGE_CHANNELS |
Create, update, delete channels |
| Channel-restricted staff |
Staff members can be limited to specific channels |
| App permissions |
Apps operate across all channels unless filtered |
Best Practices
- Create separate channels for each currency -- Saleor requires one currency per channel
- Use channel slugs that are descriptive and URL-friendly (e.g.,
us-store, eu-store)
- Assign countries to channels carefully -- shipping and tax rules depend on this
- Use the
PRIORITIZE_SORTING_ORDER allocation strategy when warehouse priority matters
- Publish products to channels explicitly -- unpublished products are invisible to storefronts
- Restrict staff access to relevant channels using channel-level permissions
- Use one channel per storefront for clear data isolation
- Plan channel structure before going live -- migrating orders between channels is not supported
Fetch the Saleor channels documentation for exact mutation inputs, allocation strategy details, and multi-brand configuration patterns before implementing.
1---2name: saleor-channels-23description: Configure Saleor channels — multi-currency, multi-region, per-channel pricing, warehouse allocation, and multi-brand setups. Use when managing multi-channel commerce.4allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch5metadata:6 source: https://skillmd.com/skills/orcaqubits/saleor-channels-27---89# Saleor Channels1011## Before writing code1213**Fetch live docs**:141. Fetch `https://docs.saleor.io/developer/channels/overview` for channels overview152. Web-search `site:docs.saleor.io channel configuration currency countries` for channel setup reference163. Web-search `site:docs.saleor.io per-channel pricing product` for channel-aware pricing174. Web-search `site:docs.saleor.io warehouse allocation channels` for warehouse-channel mapping185. Web-search `site:docs.saleor.io multi-brand multi-tenant channels` for multi-brand patterns1920## Channel Concept2122A channel represents a distinct sales context within a single Saleor instance. One Saleor deployment can serve multiple storefronts, regions, brands, or business models -- each as a separate channel.2324| Aspect | Detail |25|--------|--------|26| One instance | Single Saleor backend, shared catalog and infrastructure |27| Many channels | Each channel has its own currency, countries, pricing, and settings |28| Isolation | Customers see only channel-scoped data (prices, availability) |29| Staff access | Staff can manage all channels from one Dashboard |3031## Channel Configuration Fields3233| Field | Type | Purpose |34|-------|------|---------|35| `name` | string | Human-readable channel name |36| `slug` | string | URL-safe identifier (used in API queries) |37| `currencyCode` | string | ISO 4217 currency code (e.g., `USD`, `EUR`, `GBP`) |38| `defaultCountry` | string | ISO 3166-1 alpha-2 country code |39| `countries` | string[] | Countries where this channel operates |40| `isActive` | boolean | Whether the channel is publicly accessible |41| `stockSettings.allocationStrategy` | enum | `PRIORITIZE_HIGH_STOCK` or `PRIORITIZE_SORTING_ORDER` |42| `orderSettings.automaticallyConfirmAllNewOrders` | boolean | Auto-confirm orders |43| `orderSettings.automaticallyFulfillNonShippableGiftCard` | boolean | Auto-fulfill digital gift cards |44| `checkoutSettings.useLegacyErrorFlow` | boolean | Legacy vs new error handling |4546## Per-Channel Pricing4748Products have base prices, but each channel can define its own pricing:4950| Pricing Layer | Scope | Purpose |51|--------------|-------|---------|52| Product variant price | Per channel | Base selling price in channel currency |53| Cost price | Per channel | Cost of goods for margin calculation |54| Channel currency | Per channel | All prices in this channel use this currency |55| Tax configuration | Per channel | Tax calculation rules |56| Discounts | Per channel | Promotions scoped to specific channels |5758### Pricing Assignment5960| Entity | Channel-Scoped Fields |61|--------|----------------------|62| Product variant | `channelListings.price`, `channelListings.costPrice` |63| Product | `channelListings.isPublished`, `channelListings.publishedAt`, `channelListings.isAvailableForPurchase` |64| Collection | `channelListings.isPublished`, `channelListings.publishedAt` |65| Shipping method | `channelListings.price`, `channelListings.minimumOrderPrice`, `channelListings.maximumOrderPrice` |66| Voucher | `channelListings.discountValue`, `channelListings.minSpent` |6768## Country Assignment6970Each channel defines a set of countries it serves:7172| Aspect | Detail |73|--------|--------|74| Shipping | Only shipping methods for assigned countries are available |75| Tax | Tax rules are applied based on channel country settings |76| Address validation | Checkout validates against channel's country list |77| Warehouse selection | Warehouses are linked to countries within channels |7879## Warehouse Allocation8081Warehouses and channels are connected through country assignments:8283| Concept | Relationship |84|---------|-------------|85| Warehouse | Has a list of shipping zones it serves |86| Shipping zone | Has a list of countries |87| Channel | Has a list of countries |88| Allocation | Saleor allocates stock from warehouses that serve the channel's countries |8990### Allocation Strategies9192| Strategy | Behavior |93|----------|----------|94| `PRIORITIZE_SORTING_ORDER` | Allocate from warehouses in their configured sort order (default) |95| `PRIORITIZE_HIGH_STOCK` | Allocate from the warehouse with the most stock |9697## Channel-Aware GraphQL Queries9899Most storefront queries require a `channel` argument:100101| Query | Channel Behavior |102|-------|-----------------|103| `products(channel: "us")` | Returns products published in the US channel |104| `product(slug: "tee", channel: "us")` | Returns US-channel pricing and availability |105| `collections(channel: "us")` | Returns collections published in the US channel |106| `checkout(channel: "us")` | Creates checkout with US currency and settings |107| `shippingMethods(channel: "us")` | Returns methods available for US channel countries |108109Queries without the `channel` argument are reserved for staff/admin operations and return data across all channels.110111## Channel Creation via GraphQL112113| Mutation | Purpose |114|----------|---------|115| `channelCreate` | Create a new channel with currency and country settings |116| `channelUpdate` | Modify channel settings (countries, stock strategy) |117| `channelDelete` | Remove a channel (irreversible) |118| `channelActivate` | Make a channel publicly accessible |119| `channelDeactivate` | Hide a channel from public access |120121### Channel Creation Fields122123| Input Field | Required | Purpose |124|-------------|----------|---------|125| `name` | Yes | Display name |126| `slug` | Yes | URL-safe identifier |127| `currencyCode` | Yes | Channel currency |128| `defaultCountry` | Yes | Primary country |129| `addCountries` | No | Additional countries |130| `stockSettings` | No | Allocation strategy |131| `orderSettings` | No | Auto-confirm, fulfillment rules |132133## Multi-Brand Architecture134135Channels enable multi-brand commerce from a single Saleor instance:136137| Brand | Channel | Storefront | Currency |138|-------|---------|-----------|----------|139| Brand A (US) | `brand-a-us` | `brand-a.com` | USD |140| Brand A (EU) | `brand-a-eu` | `brand-a.eu` | EUR |141| Brand B (US) | `brand-b-us` | `brand-b.com` | USD |142| Wholesale | `wholesale` | `wholesale.brand-a.com` | USD |143144### Multi-Brand Considerations145146| Aspect | Approach |147|--------|----------|148| Product catalog | Shared catalog, per-channel publication and pricing |149| Customers | Shared customer base across channels |150| Orders | Each order belongs to one channel |151| Staff permissions | Channel-level access control for staff members |152| Apps | Apps can be channel-aware or cross-channel |153| Warehouses | Shared warehouses, per-channel allocation |154155## Channel Permissions156157| Permission | Scope |158|------------|-------|159| `MANAGE_CHANNELS` | Create, update, delete channels |160| Channel-restricted staff | Staff members can be limited to specific channels |161| App permissions | Apps operate across all channels unless filtered |162163## Best Practices164165- Create separate channels for each currency -- Saleor requires one currency per channel166- Use channel slugs that are descriptive and URL-friendly (e.g., `us-store`, `eu-store`)167- Assign countries to channels carefully -- shipping and tax rules depend on this168- Use the `PRIORITIZE_SORTING_ORDER` allocation strategy when warehouse priority matters169- Publish products to channels explicitly -- unpublished products are invisible to storefronts170- Restrict staff access to relevant channels using channel-level permissions171- Use one channel per storefront for clear data isolation172- Plan channel structure before going live -- migrating orders between channels is not supported173174Fetch the Saleor channels documentation for exact mutation inputs, allocation strategy details, and multi-brand configuration patterns before implementing.