Everything else in these docs — targeting, discounts, recommendations, translations — is a property of an offer rather than a separate thing to configure. That is worth stating plainly, because the editor presents them as tabs, which can make them feel like independent features.
An offer's products can be a fixed list you choose, or handed to ShopBrain to select per shopper. Its placement is a list rather than a single value, so one offer can run across several related surfaces at once and report as one line.
The five behavior modes
Standard — accepting adds the offered product alongside what's already in the cart. The default everywhere.
Swap — accepting replaces an item already in the cart with the offered one. This is the true upgrade pattern: the 250g bag becomes the 1kg bag in one tap, rather than making the shopper remove and re-add. Available wherever the runtime can still modify an existing line.
Auto-add — the product is added automatically as soon as the offer's conditions are met, with no click. This is how free-gift-with-purchase works: cross the threshold and the gift appears.
Mix & match — the shopper adds several of the offered products in a single action, rather than accepting one recommendation at a time. Suits starter sets, bundles and “complete the collection” offers.
Popup — a modal rather than an inline block, for when you want the offer to interrupt rather than wait to be noticed.
Which modes are available depends on the surface, and the rule is intuitive: the closer a placement sits to “the order already exists”, the fewer kinds of cart change make sense. Before payment, all five are available. Post-purchase supports standard and swap. Thank-you and account pages support standard and mix & match. See Surfaces for the full matrix.
Bundles
An offer can be backed by a bundle, so a single accept adds a defined group of products rather than one item.
When several offers qualify at once
Each offer carries a priority, which is an explicit ordering you control rather than a score to tune. When more than one offer is eligible for the same placement, the highest-priority one is shown and the rest wait their turn — so a single surface never stacks competing upsells in front of one shopper. Offers you haven't prioritised sort after the ones you have.
Separately, you can stop showing further offers once a shopper has accepted one in a session. Priority decides which offer a shopper sees first; accept-to-stop decides how many more they see afterwards. Neither changes an offer's own targeting — an offer still has to qualify on its own before either applies.
