BigCommerce Multi-Channel & Multi-Storefront
Before writing code
Fetch live docs:
- Fetch
https://docs.bigcommerce.com/developer/docs/admin/multi-storefront/overview for multi-storefront guide
- Web-search
site:developer.bigcommerce.com channels api for Channels API reference
- Web-search
bigcommerce multi-storefront setup for configuration patterns
Channel Architecture
What Channels Are
Channels represent distinct sales surfaces connected to a single BigCommerce store:
- Each channel can have its own domain, theme, currency, and locale
- Products, categories, and content can be assigned per channel
- Shared backend: orders, customers, inventory are centralized
- Channel types:
storefront, marketplace, pos, marketing
Default Channel
Every BigCommerce store has a default Stencil storefront (Channel ID 1). Additional channels are created for:
- Additional storefronts (B2B + B2C, regional sites)
- Marketplace integrations (Amazon, eBay)
- POS integrations
- Headless storefronts (Catalyst, custom)
Channels API
Endpoints
| Endpoint |
Methods |
Description |
/v3/channels |
GET, POST, PUT |
Channel CRUD |
/v3/channels/{id}/site |
GET, POST, PUT, DELETE |
Channel site (domain) |
/v3/channels/{id}/active-theme |
GET, PUT |
Active theme |
/v3/channels/{id}/currency-assignments |
GET, POST, PUT, DELETE |
Currency config |
/v3/channels/{id}/listings |
GET, POST, PUT |
Product listings |
Creating a Channel
POST /v3/channels
{
"name": "B2B Storefront",
"type": "storefront",
"platform": "catalyst",
"status": "active",
"is_listable_from_ui": true,
"is_visible": true
}
Channel Site
Associate a domain with a channel:
POST /v3/channels/{id}/site
{
"url": "https://b2b.example.com"
}
Product Channel Assignments
Assigning Products to Channels
PUT /v3/catalog/products/channel-assignments:
[
{
"product_id": 111,
"channel_id": 2
},
{
"product_id": 222,
"channel_id": 2
}
]
Querying by Channel
GET /v3/catalog/products?channel_id:in=2 — products assigned to a specific channel.
Category Channel Assignments
PUT /v3/catalog/categories/channel-assignments — assign categories to channels.
Channel-Aware APIs
Storefront API Tokens
Storefront API tokens are channel-scoped:
POST /v3/storefront/api-token
{
"channel_id": 2,
"expires_at": 1893456000,
"allowed_cors_origins": ["https://b2b.example.com"]
}
Price Lists
Different pricing per channel:
- Create a Price List with channel-specific prices
- Assign the Price List to a channel
- Customers on that channel see the assigned prices
Channel-Specific Settings
- Currency per channel
- Theme per channel
- Locale per channel
- Tax settings per channel
Multi-Storefront Patterns
B2B + B2C
- Channel 1: B2C storefront (consumer-facing)
- Channel 2: B2B storefront (wholesale pricing, customer groups)
- Same product catalog with different pricing and category visibility
Regional Storefronts
- Channel per region/country
- Different currencies, locales, and product assortments
- Shared inventory and order management
Headless + Stencil
- Channel 1: Stencil-powered storefront
- Channel 2: Catalyst (Next.js) headless storefront
- Both pulling from the same catalog
Best Practices
- Use channels for distinct sales surfaces — not for A/B testing
- Assign products explicitly to channels — don't rely on "all channels" visibility
- Use Price Lists for channel-specific pricing
- Create channel-scoped Storefront API tokens — don't share tokens across channels
- Use channel-aware webhook filters for per-channel event handling
- Plan your channel architecture before building — adding channels later requires product reassignment
- Test each channel independently
Fetch the BigCommerce Multi-Storefront documentation and Channels API reference for exact endpoints, configuration options, and current multi-storefront capabilities before implementing.
1---2name: bc-channels3description: Work with BigCommerce multi-channel — channels, multi-storefront, channel-specific catalog, site routing, and channel management API. Use when building multi-storefront solutions or managing channel-specific content.4allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch5metadata:6 source: https://skillmd.com/skills/orcaqubits/bc-channels7---89# BigCommerce Multi-Channel & Multi-Storefront1011## Before writing code1213**Fetch live docs**:141. Fetch `https://docs.bigcommerce.com/developer/docs/admin/multi-storefront/overview` for multi-storefront guide152. Web-search `site:developer.bigcommerce.com channels api` for Channels API reference163. Web-search `bigcommerce multi-storefront setup` for configuration patterns1718## Channel Architecture1920### What Channels Are2122Channels represent distinct sales surfaces connected to a single BigCommerce store:23- Each channel can have its own **domain**, **theme**, **currency**, and **locale**24- Products, categories, and content can be **assigned per channel**25- Shared backend: orders, customers, inventory are centralized26- Channel types: `storefront`, `marketplace`, `pos`, `marketing`2728### Default Channel2930Every BigCommerce store has a default Stencil storefront (Channel ID 1). Additional channels are created for:31- Additional storefronts (B2B + B2C, regional sites)32- Marketplace integrations (Amazon, eBay)33- POS integrations34- Headless storefronts (Catalyst, custom)3536## Channels API3738### Endpoints3940| Endpoint | Methods | Description |41|----------|---------|-------------|42| `/v3/channels` | GET, POST, PUT | Channel CRUD |43| `/v3/channels/{id}/site` | GET, POST, PUT, DELETE | Channel site (domain) |44| `/v3/channels/{id}/active-theme` | GET, PUT | Active theme |45| `/v3/channels/{id}/currency-assignments` | GET, POST, PUT, DELETE | Currency config |46| `/v3/channels/{id}/listings` | GET, POST, PUT | Product listings |4748### Creating a Channel4950```json51POST /v3/channels52{53 "name": "B2B Storefront",54 "type": "storefront",55 "platform": "catalyst",56 "status": "active",57 "is_listable_from_ui": true,58 "is_visible": true59}60```6162### Channel Site6364Associate a domain with a channel:65```json66POST /v3/channels/{id}/site67{68 "url": "https://b2b.example.com"69}70```7172## Product Channel Assignments7374### Assigning Products to Channels7576`PUT /v3/catalog/products/channel-assignments`:77```json78[79 {80 "product_id": 111,81 "channel_id": 282 },83 {84 "product_id": 222,85 "channel_id": 286 }87]88```8990### Querying by Channel9192`GET /v3/catalog/products?channel_id:in=2` — products assigned to a specific channel.9394### Category Channel Assignments9596`PUT /v3/catalog/categories/channel-assignments` — assign categories to channels.9798## Channel-Aware APIs99100### Storefront API Tokens101102Storefront API tokens are **channel-scoped**:103```json104POST /v3/storefront/api-token105{106 "channel_id": 2,107 "expires_at": 1893456000,108 "allowed_cors_origins": ["https://b2b.example.com"]109}110```111112### Price Lists113114Different pricing per channel:115- Create a Price List with channel-specific prices116- Assign the Price List to a channel117- Customers on that channel see the assigned prices118119### Channel-Specific Settings120121- Currency per channel122- Theme per channel123- Locale per channel124- Tax settings per channel125126## Multi-Storefront Patterns127128### B2B + B2C129130- Channel 1: B2C storefront (consumer-facing)131- Channel 2: B2B storefront (wholesale pricing, customer groups)132- Same product catalog with different pricing and category visibility133134### Regional Storefronts135136- Channel per region/country137- Different currencies, locales, and product assortments138- Shared inventory and order management139140### Headless + Stencil141142- Channel 1: Stencil-powered storefront143- Channel 2: Catalyst (Next.js) headless storefront144- Both pulling from the same catalog145146## Best Practices147148- Use channels for distinct sales surfaces — not for A/B testing149- Assign products explicitly to channels — don't rely on "all channels" visibility150- Use Price Lists for channel-specific pricing151- Create channel-scoped Storefront API tokens — don't share tokens across channels152- Use channel-aware webhook filters for per-channel event handling153- Plan your channel architecture before building — adding channels later requires product reassignment154- Test each channel independently155156Fetch the BigCommerce Multi-Storefront documentation and Channels API reference for exact endpoints, configuration options, and current multi-storefront capabilities before implementing.