Offers and behavior modes

October 8, 2026

An offer is the single unit you configure: the products, any discount, the targeting that decides who sees it, the placements it runs on, and the behavior mode that decides what happens when a shopper accepts. There are five behavior modes — standard adds the product, auto-add adds it automatically when conditions are met, swap upgrades an item already in the cart, mix & match adds several products in one action, and popup presents the offer in a modal.

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.

What you can build with it

Upgrade instead of adding. Use swap to turn an existing cart line into the larger size or premium tier, so the order value rises without the cart getting longer.

Free gift at a threshold. Auto-add a sample once the cart qualifies, paired with a progress bar so the shopper sees it coming.

Build the set in one tap. Use mix & match with a carousel so a shopper can assemble a three-item routine without navigating between product pages.

Run several offers without crowding. Give each offer a priority and turn on accept-to-stop, so a shopper who takes one offer isn't immediately shown three more.

Related Help Center articles

Try it on your store

Install UpsellPlus free and launch your first offer in minutes, or book a walkthrough with our team.