Price layers for per-buyer pricing

Price layers let you publish one product at many prices — a retail price for consumers, a wholesale price for resellers, a partner price for your favorite accounts. Each layer is just a named markup over the base product price, and each buyer link targets exactly one layer.

Where layers live

Every product has a Price Layers tab on the detail page. Layers defined there apply to that one product. There is no global layer concept — create the same layer name on every product where you want it active.

Anatomy of a layer

• tier_name — the human-readable name (Wholesale Tier 1, Partner, Repair Shop)
• margin_percent — the markup over base_price, positive or negative
• is_default — exactly one layer per product is flagged as default for links that don't specify a tier

How the price math works

The storefront calculates the displayed price as:

displayed_price = base_price × (1 + margin_percent / 100)

So a base price of $500 with a Wholesale Tier 1 layer at -10% sells to that buyer at $450. A Retail Markup layer at +20% sells at $600. Negative margins are absolutely allowed and are how most merchants run wholesale.

Creating a layer

1. Open the product detail page
2. Click Price Layers
3. Click Add Layer
4. Enter a tier name and margin percent
5. Optionally mark it as the default
6. Save — the layer becomes selectable on any buyer link

Linking buyers to layers

When you create a buyer link (Buyers → New Link), pick the tier from the dropdown. The buyer sees every product priced at that tier automatically. If the product has no matching tier, the default layer is used instead.

Reordering and deleting

• Drag the handle to reorder layers — order is purely cosmetic and only affects the display order in settings
• Delete a layer with the trash icon — any buyer link pointing at the deleted tier falls back to the default
• You cannot delete the default layer — mark another layer as default first

Common patterns

• Retail / Wholesale / Partner — three-tier B2B + B2C structure
• Grade-specific pricing handled by grade multiplier, NOT by layers — layers are for buyer segments, not quality
• Volume pricing — create a Volume Tier layer and assign it only to buyers who meet monthly minimums