Product offers and bundles: the parts, in plain words

33 parts and 14 phrases. Apps in this area include ReConvert, Rebuy, Bold Upsell, Zipify OCU, Frequently Bought Together, Fast Bundle.

Offersupsell.offerShowWhat is offered, where it comes from, when it is shown and how it is priced.

Offer typeupsell.offer.typeShowHow the offered product relates to the one being bought.

How to extend

SlotMany side by sidestorefront.slot.product.below_buy_box storefront.slot.cart.below_itemsAn upsell plugin renders its offers in named places on the product page and cart.

Part	Litestore today	How to extend
Upgrade offer`upsell.offer.type.upgrade`An upsell offers a larger, higher-priced or upgraded version of the product being bought.	Plugin	Slot · many
Companion product`upsell.offer.type.companion`A cross-sell offers a different product that goes with the one being bought.	Core`modules/checkout/storefront/cart-recommendations.tsx`	Slot · many
Cheaper alternative`upsell.offer.type.cheaper_alternative`A downsell offers a cheaper product after the shopper turns down a first offer.	Plugin	Slot · many
Add-on`upsell.offer.type.add_on`An add-on is an extra such as installation or a warranty that is bought attached to one product line.	Core`modules/checkout/cart-lines.ts`	Slot · many

Where offers come fromupsell.offer.sourceShowHow the offered products are chosen.

How to extend

ProviderOne per storerecommendation providerA recommendation service returns ranked product ids for a product or cart in place of the built-in ranking.

Part	Litestore today	How to extend
Hand-picked products`upsell.offer.source.manual`Hand-picked offers are products staff choose for a given product or cart condition.	Plugin	Provider · one
Same collection or category`upsell.offer.source.same_collection`Same-collection offers are products that share a collection or category with the product, ranked by match and popularity.	Core`modules/products/storefront/queries.ts`	Provider · one
Popular products`upsell.offer.source.popular`Trending offers are the store's popular products, shown when no related product is found.	Core`modules/checkout/storefront/cart-recommendations.tsx`	Provider · one
Bought in the same orders`upsell.offer.source.co_purchased`Bought-together offers are products that past orders most often contain alongside the product.	Plugin	Provider · one
Recently viewed`upsell.offer.source.recently_viewed`Recently viewed offers are products the shopper opened earlier in their visit.	Plugin	Provider · one
Model-ranked`upsell.offer.source.model_ranked`Model-ranked offers are products ordered by a machine learning model trained on the store's browsing and order data.	Plugin	Provider · one

When offers showupsell.offer.momentShowThe point in the shopper's path where an offer appears.

How to extend

SlotMany side by sidestorefront.slot.product.below_buy_box storefront.slot.cart.below_items checkout.slot.confirmation.mainOffer placements are slots; a plugin renders its offer in the slot for that moment.
EventMany side by sideevent.order.paidA post-purchase plugin subscribes to paid orders to send a follow-up offer.

Part	Litestore today	How to extend
On the product page`upsell.offer.moment.product_page`A product page offer shows related products on the product page, below or beside the buy button.	Core`modules/storefront/pages/related-products.tsx`	Slot · manyEvent · many
In the cart`upsell.offer.moment.cart`A cart offer shows products under the cart lines that are not already in the cart.	Core`modules/checkout/storefront/cart-recommendations.tsx`	Slot · manyEvent · many
After add to cart`upsell.offer.moment.after_add`An add-to-cart offer opens a popup with extra products right after the shopper adds an item.	Plugin	Slot · manyEvent · many
In checkout`upsell.offer.moment.checkout`A checkout offer shows an extra product inside the checkout before payment.	Plugin	Slot · manyEvent · many
After payment, same payment method`upsell.offer.moment.after_payment`A post-purchase offer appears after payment and before the thank-you page, and accepting it charges the same payment again without new card details.	Plugin	Slot · manyEvent · many
On the order confirmation page`upsell.offer.moment.confirmation_page`A thank-you page offer shows products on the order confirmation page, which are bought in a new checkout.	Plugin	Slot · manyEvent · many

Offer priceupsell.offer.priceShowThe incentive attached to an offer.

How to extend

ProviderMany side by sidediscount rule providerAn offer discount is priced by the discount rules, so a plugin offer uses the same rule seam as other discounts.

Part	Litestore today	How to extend
Offer discount`upsell.offer.price.offer_discount`An offer discount reduces the price of the offered product only when it is taken from the offer.	Plugin	Provider · many
Bundle code`upsell.offer.price.bundle_code`A bundle code is a public discount code tied to a bundle's collection and shown with the bundle.	Core`modules/storefront/sections/section-coupon.ts`	Provider · many
Product to reach free shipping`upsell.offer.price.threshold_filler`A free shipping unlock offers a product whose price lifts the cart over the free-shipping threshold.	Plugin	Provider · many

Bundlesupsell.bundleShowProducts sold together as a set.

How to extend

SectionMany side by sidestorefront.section.bundleA bundle section shows a set of products with their total on any storefront page.

Part	Litestore today	How to extend
Fixed bundle`upsell.bundle.fixed`A fixed bundle is a set list of products and quantities that is added to the cart in one click as one line per product.	Core`modules/catalog/storefront/collections/add-bundle-to-cart.tsx`	Section · many
Bundle section`upsell.bundle.bundle_section`A bundle section shows a set of products with their combined price and any linked code on a storefront page.	Core`modules/storefront/sections/product-set.tsx`	Section · many
Pick from a group`upsell.bundle.pick_from_group`A mix-and-match bundle lets the shopper pick a set number of items from a group for one bundle price.	Plugin	Section · many
Quantity price steps`upsell.bundle.quantity_price_steps`Volume tiers lower the unit price as more of the same product is bought, such as one, two or three packs.	Plugin	Section · many
Box filled step by step`upsell.bundle.filled_box`A build-a-box bundle fills a box of set size step by step from chosen products and prices the box as a whole.	Plugin	Section · many
Bundle with its own stock`upsell.bundle.stocked_bundle`A bundle with its own stock is a product with its own SKU and price whose sale lowers the stock of each component.	Plugin	Section · many

Targeting rulesupsell.ruleShowWhich shoppers and carts see which offer.

How to extend

Core onlyBuilt-in rules only filter what core already shows; offer targeting beyond that belongs to the plugin that owns the offer.

Part	Litestore today	How to extend
Skip items in cart`upsell.rule.exclude_in_cart`A skip rule leaves out products already in the cart from the offers.	Core`modules/checkout/storefront/cart-recommendations.tsx`	Core only
In stock only`upsell.rule.in_stock_only`An in-stock rule leaves out products that cannot be sold right now.	Core`modules/products/storefront/queries.ts`	Core only
Trigger product`upsell.rule.trigger_product`A trigger product rule shows an offer only when a named product or collection is in the cart or order.	Plugin	Core only
Cart value rule`upsell.rule.cart_value`A cart value rule shows an offer only when the cart total is within a set range.	Plugin	Core only
Offer split test`upsell.rule.split_test`An offer split test shows two versions of an offer to separate shoppers and records which one sells more.	Plugin	Core only

Measurementupsell.measureShowHow offers are counted.

How to extend

EventMany side by sideevent.order.paid event.cart.item_addedA plugin counts offer views and takes from cart and order events.

Part	Litestore today	How to extend
Offer views`upsell.measure.offer_views`Offer views count how many times each offer was shown.	Plugin	Event · many
Acceptance rate`upsell.measure.accept_rate`Take rate is the share of shown offers that were added to the cart or accepted.	Plugin	Event · many
Offer revenue`upsell.measure.offer_revenue`Offer revenue sums the order value that came from accepted offers.	Plugin	Event · many

Phrase	Made of
post-purchase upsell	upsell.offer.moment.after_payment upsell.offer.type.upgrade
one-click upsell	upsell.offer.moment.after_payment
frequently bought together	upsell.offer.source.co_purchased upsell.offer.moment.product_page
you may also like	upsell.offer.source.same_collection upsell.offer.moment.product_page
in-cart upsell	upsell.offer.moment.cart
thank you page upsell	upsell.offer.moment.confirmation_page
mix and match	upsell.bundle.pick_from_group
build a box	upsell.bundle.filled_box
quantity breaks	upsell.bundle.quantity_price_steps
product bundles	upsell.bundle.fixed
product add-ons	upsell.offer.type.add_on
downsell	upsell.offer.type.cheaper_alternative
recently viewed products	upsell.offer.source.recently_viewed
upsell popup	upsell.offer.moment.after_add

Product offers and bundles

What the phrases mean

Phrases left out

Sources