Concept

How per-channel pricing works

One catalog, many storefronts. A dealer, a marketplace and your own store price the same sofa differently, without touching the catalog.

, imagine.io ·

A sales channel is a storefront, dealer or portal that sells the same catalog on its own terms. Each channel gets its own product and option prices, option defaults, theme and sharing links, without touching the catalog itself. Catalog prices are the fallback: anything a channel does not override is sold everywhere at the catalog price.

CATALOGOne catalogSofa 1,299Velvet +350Chaise +900Your storecatalog pricesno channel2,549velvet sofa with chaiseDealer portalsofa 1,099, velvet +300link made under the channel2,299velvet sofa with chaiseMarketplacesofa 1,399, options as catalogSDK: setChannelId(id)2,649velvet sofa with chaiseany product or option price a channel does not override falls back to the catalog CATALOGOne catalogSofa 1,299Velvet +350Chaise +900Your storecatalog pricesno channel2,549velvet sofawith chaiseDealer portalsofa 1,099velvet +300link made under the channel2,299velvet sofawith chaiseMarketplacesofa 1,399options as catalogSDK: setChannelId(id)2,649velvet sofawith chaiseany price a channel does not overridefalls back to the catalog
One catalog, three storefronts. A channel overrides the product and option prices it needs; the engine prices every click for the channel the request came from.

What a channel holds

Under Commerce › Sales Channels each channel has four tabs:

  • Details. The name, and the products and option sets this channel sells; a channel only exposes what you attach to it. A dealer channel also gets an embed token: the key a dealer's own backend uses with the channel API to read this channel's products, option sets and saved projects. Regenerate it to cut off a dealer still using the old one.
  • Overrides. The option defaults this channel opens with. Set channel-wide defaults, then override them for a single product where a dealer wants something different. Per option, a different price or a hidden flag for this channel.
  • Product Prices. A price per product that replaces its base price for this channel only. Clear it to fall back to the catalog price.
  • System Config. Per-system settings for this channel: a starting preset and a theme that override the system's own, its own sharing links, and the same interface toggles as on the system. A link made here carries the channel's prices and defaults; a link made on the system opens with the system's own defaults at catalog prices.

How the configurator picks the channel

// 1. A sharing link created under the channel (Commerce › Sales Channels › System Config › Sharing Links)
//    carries the channel. Nothing to pass. A link made on the system itself opens with the
//    system's own defaults at catalog prices.

// 2. A page with the SDK sets it before mount()
import { mount, config } from '@imagineio/configurator-sdk';
config.setChannelId(42);                       // the channel's id, not its name
const app = mount('#root', { systemId: 12, getToken });

What the engine does with it

On every change the engine prices the resolved configuration for the channel the request came from: the channel's product price where one is set, otherwise the catalog price, plus each chosen option at the channel's price where one is set, otherwise its catalog adjustment. Rules and constraints limited to the channel run only there. The pricing object your page receives is already the channel's; there is nothing to apply on the page.

A dealer who saves a design gets a quote PDF with the dealer's prices, and the project shows in your dashboard with the channel it came from.

Frequently asked questions

Does a channel need its own catalog?

No. One catalog, many channels. A channel only overrides prices, defaults, theme and which products and option sets it exposes. Anything it does not override comes from the catalog.

How does the configurator know which channel it is in?

From the link or the page. A sharing link created under the channel (Commerce › Sales Channels › System Config › Sharing Links) carries it; a link made on the system itself opens with the system's own defaults at catalog prices. A page with the SDK calls config.setChannelId() with the channel's id before mount(). There is no parameter to add to a link.

Can I hide products or options from one channel?

Yes. A channel exposes only the products and option sets attached to it, and rules and constraints can be limited to a channel, so a dealer portal can offer a narrower range than your own store.

What if a dealer's site is compromised?

Remove the sharing link, or take the dealer's domain off the link's allowed domains, and the embed stops loading. If the dealer also uses the channel API from their own backend, regenerate the channel's embed token so the old one stops working.

Is this on the free plan?

Sales Channels is a paid feature. On the free plan the page shows an Upgrade pill in the sidebar; everything you set up there is kept and appears when you upgrade.

SDK documentation · Admin guide