Pricing and quotes
A 3D configurator with live pricing and quotes
Prices set once in the dashboard, computed by the engine on every click, and handed to your cart, your dealers and the quote PDF from one record.
Every click in an imagine.io configurator is priced on the server from the option prices and per-channel overrides you set in the dashboard, and the shopper can save the design, share a link and download a quote PDF with the bill of materials.
How prices are set
Prices live in the dashboard, next to the things they price: a base price on a product or variant, and an amount on each option, such as a fabric, a leg style or a wider oven. There is nothing to compute in a spreadsheet and nothing to copy into a website.
On every change the engine prices the resolved configuration and returns one pricing object: a base price and the option adjustments for each placed product, that product's unit price, any scene-wide adjustments such as bundles, and the grand total.
{
"currency": "USD",
"grandTotal": 8495,
"placements": {
"p1": {
"basePrice": 1299,
"adjustments": [
{ "optionSetId": 19, "optionSetLabel": "Arm Style", "optionId": 181, "label": "Anne Arm 1", "amount": 0 },
{ "optionSetId": 21, "optionSetLabel": "Fabric", "optionId": 204, "label": "Velvet", "amount": 350 }
],
"unitPrice": 1649
}
},
"aggregateAdjustments": []
}A rejected change (a constraint said no) returns no price, because nothing changed. The previous price stands.
Per-channel pricing
A sales channel is a storefront, dealer or portal that sells the same catalog on its own terms. Each channel has a Product Prices tab, where a price per product replaces the catalog price for that channel only, and an Overrides tab for the option defaults it opens with. Catalog prices are the fallback: anything a channel does not override is sold at the catalog price.
A sharing link created from the channel carries the channel's prices and defaults; so does a page that passes the channel's embed token, or an SDK page that calls config.setChannelId(). Rules and constraints can be limited to one channel too. How per-channel pricing works goes through each tab.
Quotes and the bill of materials
When the shopper saves a design, the platform keeps the configuration, produces a share link that reopens it exactly, and builds a quote PDF: every placed product, its chosen options by name, each line's price and the total. In the dashboard, Projects lists every saved configuration with its customer, system, status and total, and the PDF is there to download.
For your own systems, the same record is available as data: on a page with the SDK, quote.read() returns the lines with named selections and formatted prices; in an iframe, the getQuote command returns the same through the bridge.
How the price reaches your cart
The configurator tells your page about every price change, and hands over the quote on request:
// In an iframe: the bridge
window.addEventListener('message', (e) => {
const m = e.data;
if (m?.type === 'configurator:event' && m.event === 'price.changed') {
button.textContent = `Add to cart: ${m.data.currency} ${m.data.grandTotal}`;
}
});
const quote = await callConfigurator(iframe, 'getQuote'); // itemised, priced by the engine
// With the SDK on the page
import { on, quote } from '@imagineio/configurator-sdk';
on('price.changed', (pricing) => badge.textContent = pricing.grandTotal);
const q = quote.read(); // lines, totals, system nameThe cart line carries the engine's total, the lines, a thumbnail and the snapshot that reopens the build. The bridge chapter and the Shopify guide show the full hand-off.
Frequently asked questions
Is the price computed in the browser?
No. Every change is sent to the engine, which prices the resolved configuration from the option prices and the channel's overrides and returns one pricing object. The page shows that number; it never adds up catalog prices itself.
Can a dealer see different prices from my own store?
Yes. A sales channel is a storefront, dealer or portal that sells the same catalog on its own terms, with its own product prices, option defaults and theme. A link made from the channel carries those prices; anything the channel does not override falls back to the catalog price.
Can the shopper download a quote?
Yes. A saved configuration has a share link and a quote PDF with the bill of materials. In the dashboard, every saved project is listed with its customer, system, status and total, and the PDF can be downloaded there too. Seeing projects in the dashboard is part of a paid plan.
Does the quote list every part?
It lists every placed product with its chosen options resolved to names, each line's price and the grand total. The same evaluation that priced the configuration produced the list, so the quote, the cart and the factory's record agree.
What if a price changes while a shopper is configuring?
Every request carries the catalog version the page loaded with. If a new version was published meanwhile, the engine answers 409, the SDK retries the same change once with the current version, and the shopper sees the current prices.