Cart Incentive State
The threshold-aware state switcher for Cart Incentive — swaps Under/Over-Threshold designs.
Last updated
How to use
Place this component in your cart design.
Bind
✦ Recipe ID(andThresholdfor canvas preview) from the Butter plugin, or set them manually.Connect your
Under ThresholdandOver Thresholddesigns, then place Cart Incentive Amount and Cart Incentive Bar inside as you please.
Before a live cart is connected, canvas shows your Under Threshold design by default (or Over Threshold if Under is left empty).
Setting the incentive threshold
Live, the threshold customers see comes from the connected Recipe — the Threshold control here is a canvas and preview stand-in, so what you set here is for styling and testing, not the number customers actually see in production.
The optional Start after control is for multi-checkpoint incentives, where one threshold should only start counting once an earlier one is reached. For example, if one Recipe unlocks free shipping at $20 and another unlocks a free gift at $50, enter the free-shipping Recipe's ID in Start after on the free-gift incentive — its progress then starts from $20 rather than $0.
Sharing data with Amount and Bar
Cart Incentive State is the single place you configure ✦ Recipe ID, Start after, and Threshold for the whole family — any Cart Incentive Amount or Cart Incentive Bar nested inside its designs inherits those values automatically, so they never need to be set again downstream.