Rebuy offers widgets and tools that recommend products, increase cart value, and personalize the shopping experience at every stage of the customer journey. Every widget is powered by a data source (ruleset) that determines which products are shown and when.
Use the quick-pick table to find the right widget for your goal, or browse the full reference by location.
How Rebuy widgets are organized
Rebuy widgets are defined by three separate settings, and understanding the difference explains why several differently-named widgets behave the same way in reporting.
Widget type is what the widget does, such as a cross-sell, an upsell, or a gift with purchase. The type is chosen when the widget is created.
Placement is which page or surface the widget appears on, such as the home page, a product page, or the cart. Several widgets in this article share one type and differ only by placement.
Display type and trigger control whether the widget is embedded in the page or appears as a pop-up, and what causes a pop-up to open.
Because the widget type is what Rebuy records on an order, two widgets that share a type also share an attribution value even when they have different names in this article. The section "Order line item attribution values" below lists each value and which widgets write it.
Layout and behavior changes that the widget settings do not cover require editing your theme code. Custom template work is carried out by your own developer or a Rebuy Partner agency, and Rebuy support does not build or troubleshoot it. If you have a developer, the technical starting point is Developer reference: widget custom templates.
Choose a widget by goal
This table maps common merchandising goals to the widget or tool that handles them. Each linked article covers full setup.
My goal | Recommended widget(s) |
Show product recommendations on the home page | |
Show product recommendations on a collection page | |
Recommend additional products on the product page | |
Upsell to a higher-value product | |
Convert one-time buyers to subscribers | |
Offer a free or discounted gift | |
Offer customizable product bundles | |
Recommend additional products inside the cart | |
Show a last-chance offer before checkout | |
Recover abandoning visitors | |
Recommend products at checkout | |
Offer a discounted product after payment | |
Recommend products on customer account pages | |
Let customers reorder past purchases from their account | |
Re-engage customers via email or SMS | |
Improve on-site search | |
Merchandise collection pages | |
Automate cart-based promotions and gift offers | |
Offer quantity-break discounts on the product page |
Home and collection page widgets
Home and collection page widgets surface product recommendations at the top of the shopping journey, before a customer reaches a specific product.
Home Page Cross-Sell
The Home Page Cross-Sell widget displays product recommendations on your store's home page. It is commonly used for top sellers, featured collections, or new arrivals.
Collection Page Widget
The Collection Page Widget displays product recommendations on collection pages, helping shoppers discover additional products while browsing.
Product page widgets
Product page widgets appear on the highest-intent location in your store. They recommend related products, trigger add-to-cart offers, drive subscription upgrades, and add gift or add-on logic at the moment a customer is most engaged.
AI Recommendation / Standard Cross-Sell
The AI Recommendation widget, also called the Standard Cross-Sell or Product Cross-Sell widget, embeds product recommendations directly on the product page as a grid or carousel. Its data source can be AI-driven, collection-based, or manually configured.
Add to Cart Cross-Sell (Popup)
The Add to Cart Cross-Sell widget, also called the Product Page Popup Widget, opens a pop-up when a customer clicks Add to Cart on a Shopify product page and recommends additional products to add alongside the original item. The original item stays in the cart.
Add to Cart Upsell (Popup)
The Add to Cart Upsell widget, also called the Product Upsell widget, opens a pop-up when a customer clicks Add to Cart and offers a higher-value replacement for the original item. If the customer accepts, the original item is swapped out of the cart.
Add to Cart Subscription Upsell (Popup)
The Add to Cart Subscription Upsell widget, also called the Switch to Subscription pop-up, opens a pop-up when a customer adds a one-time product and offers to upgrade it to a subscription version. If the customer accepts, the one-time item is replaced with the subscription variant. This widget is a different feature from the Switch to Subscription option built into the Smart Cart, and the section "Widget names that refer to more than one feature" below covers how to tell them apart.
Product Add-Ons Widget
The Product Add-Ons Widget displays complementary products with checkboxes on the product page. It has no standalone Add to Cart button. Selected add-on items are added to the cart alongside the main product when the page's primary Add to Cart button is clicked.
Dynamic Bundle Widget
The Dynamic Bundle Widget displays a "Frequently Bought Together" style bundle on the product page. Customers select which items to include and add the entire bundle to the cart with one click. The Dynamic Bundle Widget is a different feature from Bundle Builder, which is a multi-step experience installed on its own dedicated Shopify page.
Gift With Purchase Widget
The Gift With Purchase Widget automatically adds gift products to the cart when its data source conditions are met, and automatically removes them when those conditions are no longer satisfied. The widget adds every product its data source returns, so one Gift With Purchase Widget can add more than one gift. What it does not do is let the customer choose, since the gifts are added for them. To let a customer pick one gift from several options, use the Selectable Gift With Purchase Widget described under "Cart widgets" below.
Buy More Save More Product Page Widget
The Buy More Save More (BMSM) Product Page Widget shows volume-based quantity-break discounts directly on your product page, rewarding larger quantities with a bigger discount, such as "Buy 1," "Buy 3, save 10%," and "Buy 5, save 20%." The Buy More Save More Product Page Widget is a different feature from the Buy More Save More discount inside the Smart Cart, and the section "Widget names that refer to more than one feature" below covers how to tell them apart.
Cart widgets
Cart widgets give customers a chance to add more products before they reach checkout. Most appear inside the Rebuy Smart Cart, and the Cart Page Widget appears on the standard Shopify cart page instead.
Cart Cross-Sell (Popup)
The Cart Cross-Sell (Popup) widget opens a pop-up from the cart that recommends products to add alongside the items already in the cart.
Cart Cross-Sell (Embedded)
The Cart Cross-Sell (Embedded) widget displays product recommendations as an embedded section directly inside the Smart Cart, with no pop-up.
Selectable Gift With Purchase Widget
The Selectable Gift With Purchase Widget lets customers choose one gift from several options through a pop-up in the cart. It is built as a Cart Cross-Sell widget configured as a gift picker rather than as a separate widget type, which is why it is set up differently from the standard Gift With Purchase Widget and why it is reported as a cart widget.
Pre-Purchase Popup Widget
The Pre-Purchase Popup Widget appears between the Smart Cart checkout button and the Shopify checkout page, presenting a last-chance offer before the customer enters payment.
Cart Page Widget
The Cart Page Widget displays product recommendations as an embedded section directly inside the standard Shopify cart page, rather than inside the Smart Cart.
Checkout widgets
Checkout widgets are Rebuy's Checkout Extensions, and they are the only widget types that can be placed on the Shopify checkout page. They can also appear on the Thank You page, the Order Status page, and the Shopify customer account pages. No other Rebuy widget type can be added to the checkout page, and that includes the Smart Cart, cart widgets, product page widgets, and pop-ups. All Checkout Extensions are installed through the Shopify checkout and accounts editor rather than through your theme.
Plan gating follows the placement, not the widget. Placement inside the checkout itself requires Shopify Plus, while the Thank You page, the Order Status page, and the customer account pages are available on every Shopify plan.
Recommendations (Checkout Extensions)
The Recommendations Checkout Extension displays product recommendations based on the customer's current cart or order history, and it can be placed inside the checkout, on the Thank You page, on the Order Status page, and on the Orders and Profile customer account pages. Placement on the Checkout page is available exclusively to Shopify Plus merchants, and every other placement works on all plans. Recommendations is one of the widget options that carries the ORDERS location tag, which is what makes it selectable for a customer account page.
Content Block (Checkout Extensions)
The Content Block Checkout Extension creates image and copy blocks for custom messaging or brand content, and it can be placed inside the checkout, on the Thank You page, on the Order Status page, and on the Orders and Profile customer account pages. Placement inside the checkout requires Shopify Plus, and merchants on any plan can place Content Blocks on the Thank You page, the Order Status page, and the customer account pages. Content Block is the other widget option that carries the ORDERS location tag, so it is selectable for a customer account page.
Line Item Editor (Checkout Extensions)
The Line Item Editor Checkout Extension configures line item settings for products at checkout, such as offering a Switch to Subscription upgrade. You can add one Line Item Editor per checkout, and it requires Shopify Plus.
Progress Bar (Checkout Extensions)
The Progress Bar Checkout Extension displays a free shipping threshold progress bar at checkout to increase average order value. You can add one Progress Bar per checkout, and it requires Shopify Plus.
Rebuy Monetize
Rebuy Monetize displays third-party advertiser offers on the Thank You page and the Order Status page, and those are the only two surfaces it renders on. Merchants earn revenue when shoppers click Accept Offer, and the payout value is determined by click-through and conversion performance. A Rebuy Monetize widget added to a customer account page does not appear there, so use Recommendations or Content Block for that surface instead.
Post-purchase widgets
Post-purchase widgets present offers immediately after a customer completes payment and before they reach the order confirmation page. Customers can accept these offers without re-entering payment details.
Post Purchase Widget
The Post Purchase Widget appears immediately after payment and before the order confirmation page. Customers can accept or decline a discounted or free product offer without re-entering payment information.
Account page widgets
An account page widget places product recommendations or a content block on the account pages a signed-in customer sees, which reaches people who have already bought from you. A common use is a Shoppable Order History that lets a customer reorder what they bought before, built by pointing the widget's data source at Buy It Again.
How you build an account page widget depends on which version of Shopify customer accounts your store runs. The two versions use separate install methods, separate widget types, and separate editors, and nothing carries over between them. To check which version you are on, go to Settings in your Shopify admin, then Customer accounts, then Configurations, and click Customize. If that routes you to the Shopify checkout configuration page, your store is on new customer accounts.
Account page widgets on new customer accounts
On new customer accounts, an account page widget is a Checkout Extensions widget rather than a theme widget. You build it under Checkout & Post-Purchase and then Checkout Extensions in the Rebuy admin, then install it as the Rebuy Smart Component block from Shopify's checkout and accounts editor. Your theme is not involved.
Account page widgets on classic customer accounts
On classic customer accounts, an account page widget is a standard onsite widget installed into the templates/customers/account.liquid file in your theme, created from the Account Page card on the Widgets tab. This is the older method, and a widget built this way renders only while your store stays on classic customer accounts.
Bundle Builder
Bundle Builder is a guided, multi-step "build your own bundle" experience installed on a dedicated Shopify page. It includes a built-in progress bar, native Gift With Purchase functionality, and Cart Transform API support for displaying a completed bundle as a single line item in the cart. Bundle Builder is a different feature from the Dynamic Bundle Widget, which is a single-step bundle that sits on the product page.
Store-wide personalization tools
These Rebuy tools personalize the storefront but are not tied to a single page widget the way the widgets above are.
Smart Search
Smart Search is a customizable search experience that replaces the native Shopify search with a Quick View dropdown and a full Results Page. It supports keyword rules, product and metafield filters, and suggested search terms.
Smart Collections
Smart Collections replaces standard Shopify collection pages with a personalized, merchandised experience. It supports behavior-based sorting, tag and metafield filtering, featured products, promo tiles, campaign scheduling, and collection analytics.
Smart Flows
Smart Flows is an automation tool that triggers cart-based actions, pop-ups, and gift offers based on conditions including cart contents, subtotal, UTM parameters, date ranges, and customer data. It supports multi-tier Buy X, Get Y flows and conditional branching.
Smart Links
Smart Links generates shareable URLs that pre-load specific products into the cart with an optional discount code and redirect customers to a specified landing page. Smart Links are used in marketing campaigns and email flows.
Landing page widgets
Landing page widgets create personalized pages that you link to from email or SMS campaigns.
Reorder Landing Page
The Reorder Landing Page is a personalized page linked from email or SMS that pre-populates a customer's cart with their previous order items for easy reordering.
Reactivate Landing Page
The Reactivate Landing Page is a personalized page that re-engages lapsed customers by presenting their previous purchases and prompting them to buy again.
Third-party page widgets
Rebuy widgets can be installed on third-party order tracking pages to surface product recommendations at post-purchase touchpoints.
Malomo Widget
The Malomo Widget displays Rebuy product recommendations on Malomo order tracking pages.
Wonderment Widget
The Wonderment Widget displays Rebuy product recommendations on Wonderment order tracking pages.
Passport Widget
The Passport Widget displays Rebuy product recommendations on Passport-powered pages.
Pop-up triggers
A pop-up is not a separate widget type in Rebuy. A pop-up is a product or cart widget with its Display Type set to Popup instead of Embed, plus a trigger that controls when it opens. This is why widgets such as the Add to Cart Cross-Sell, the Add to Cart Upsell, and the Exit Intent Popup share a type with their embedded equivalents and are reported the same way.
The table below lists the pop-up triggers you can choose from and what causes each one to fire.
Trigger | Displays when |
Page Load | The page loads |
Add To Cart | The customer clicks Add to Cart |
Submit Event | A form is submitted |
Exit Intent | The customer shows intent to leave the page |
Check Out | The customer clicks the checkout button |
Exit Intent Popup Widget
The Exit Intent Popup Widget is a product or cart widget using the Exit Intent trigger, which opens a pop-up when a customer shows intent to leave the page. It is used to display a last-chance product recommendation or offer before the customer exits. There is no separate "Exit Intent" entry in the widget type list, so to build one you create a product or cart widget, set its Display Type to Popup, and set its trigger to Exit Intent.
Widget names that refer to more than one feature
Some Rebuy names describe more than one feature, and confirming which one you are using prevents applying the wrong setup steps or misreading a report. Each row below is a single feature, with where that feature lives and the attribution value it writes.
Name | Which feature | Where it lives | Attribution value it writes |
Buy More Save More | Buy More Save More Product Page Widget | A standalone widget on the product page |
|
Buy More Save More | Buy More Save More discount | Inside the Smart Cart, at Smart Cart Settings > Cart Items > Buy More Save More |
|
Switch to Subscription | Add to Cart Subscription Upsell pop-up widget | A standalone widget on the product page |
|
Switch to Subscription | Switch to Subscription option | Inside the Smart Cart |
|
Gift With Purchase | Gift With Purchase Widget | A standalone widget that adds its gifts automatically |
|
Gift With Purchase | Selectable Gift With Purchase Widget | A Cart Cross-Sell widget configured as a gift picker in the cart |
|
The two Buy More Save More features write different attribution values, so an order can tell them apart. The two Switch to Subscription features write the same attribution value and cannot be separated by attribution alone, so see Reporting Analytics FAQs for how to distinguish them.
Order line item attribution values
When a Rebuy widget adds a product to the cart, it stamps an _attribution property on that Shopify order line item. This section lists which value each widget writes, so you can identify the source of a line item on an order or in the Sales Attribution by Type breakdown of your reports.
This section covers only which value each widget writes. To stop attribution properties from appearing on your orders, see Hide Rebuy Attribution Tracking Properties. To interpret attributed revenue and read your reports, see Performance Report.
Several widgets share one attribution value because they share one widget type. The table below covers the widgets documented in this article, grouped by value so you can see which widgets are combined under each one.
Attribution value | Widgets that write it |
| Home Page Cross-Sell, Collection Page Widget, AI Recommendation / Standard Cross-Sell, Add to Cart Cross-Sell (Popup) |
| Cart Cross-Sell (Popup), Cart Cross-Sell (Embedded), Cart Page Widget, Selectable Gift With Purchase Widget |
| Add to Cart Upsell (Popup) |
| Add to Cart Subscription Upsell (Popup), and the Switch to Subscription option in the Smart Cart |
| Product Add-Ons Widget |
| Dynamic Bundle Widget |
| Gift With Purchase Widget, and a Checkout Extensions offer set to be treated as a gift with purchase |
| Buy More Save More Product Page Widget on a one-time purchase line |
| Buy More Save More Product Page Widget on a subscription line |
| The Buy More Save More discount inside the Smart Cart |
| Bundle Builder on a one-time purchase line |
| Bundle Builder on a subscription line |
| A gift added by Bundle Builder's built-in Gift With Purchase |
| Pre-Purchase Popup Widget |
| Post Purchase Widget |
| Recommendations (Checkout Extensions), including one placed on a customer account page |
| Line Item Editor (Checkout Extensions) |
| Progress Bar (Checkout Extensions), and the Tiered Progress Bar in the Smart Cart |
| The Switch to One-Time option in the Smart Cart |
| Smart Search |
| Smart Collections |
| Smart Flows |
| Reorder Landing Page |
| Malomo Widget |
| Wonderment Widget |
Two details affect how you read these values:
The Smart Cart writes a cart-level attribution, not a line item one. Its value is
Smart CartorSmart Cart 2.0, it is stored on the cart rather than on a line item, and it does not contribute to Rebuy Generated Revenue. See Smart Cart Attributions.A widget placed on a third-party page writes that page's value instead. A widget installed on a Malomo or Wonderment tracking page writes the tracking page value shown above rather than the value for its underlying widget type.
Frequently asked questions
Why do several of my widgets show the same attribution value?
Several widgets show the same attribution value because attribution is recorded per widget type, not per widget. The Home Page Cross-Sell, Collection Page Widget, AI Recommendation, and Add to Cart Cross-Sell are all the same widget type placed in different locations, so they all write Rebuy Product. The same applies to the widgets that write Rebuy Cart.
How do I tell which specific widget added a product to an order?
To tell which specific widget added a product, use the Rebuy Line Item Widget ID column in your Performance Report CSV rather than the attribution value. Every widget stamps its own unique ID on the line items it adds, so the ID separates widgets that share one attribution value. Two cases need care. Smart Cart features such as Switch to Subscription are not widgets and stamp no ID of their own, and because the Smart Cart preserves the line item properties already present, a widget ID on such a line can point at whichever widget originally added the item rather than at the feature that changed it.
What is the difference between the Buy More Save More widget and Buy More Save More in the Smart Cart?
The Buy More Save More Product Page Widget and the Buy More Save More discount in the Smart Cart are two different features that share a name. The Buy More Save More Product Page Widget is a standalone widget that shows quantity-break tiers on the product page and writes Rebuy Widget Buy More Save More. The Buy More Save More discount is configured inside the Smart Cart at Smart Cart Settings > Cart Items > Buy More Save More and writes Rebuy Buy More Save More, so the two can be told apart on an order.
What is the difference between the Dynamic Bundle Widget and Bundle Builder?
The Dynamic Bundle Widget and Bundle Builder are two different bundle features. The Dynamic Bundle Widget shows a single-step "Frequently Bought Together" bundle on the product page. Bundle Builder is a guided, multi-step "build your own bundle" experience installed on its own dedicated Shopify page, with a built-in progress bar, native Gift With Purchase functionality, and Cart Transform API support.
Can I let customers choose their own gift with the Gift With Purchase Widget?
No, the Gift With Purchase Widget does not let customers choose their gift, because it adds the qualifying gifts to the cart automatically. It is not limited to a single gift, since it adds every product its data source returns, but the customer does not pick among them. To let a customer choose one gift from several options, use the Selectable Gift With Purchase Widget, which is built as a Cart Cross-Sell widget configured as a gift picker in the cart.
Can I add a Rebuy widget to the Shopify checkout page?
Only Rebuy's Checkout Extensions can be placed on the Shopify checkout page, and doing so requires Shopify Plus. The Smart Cart, cart widgets, product page widgets, and pop-ups cannot be added to checkout on any plan. Checkout Extensions are installed through the Rebuy app block in the Shopify Checkout Editor.
Does the Smart Cart attribution count toward my Rebuy Generated Revenue?
No, the Smart Cart attribution does not count toward Rebuy Generated Revenue. It is a cart-level attribute used for reporting visibility only, and widgets are what contribute to Rebuy Generated Revenue. See Smart Cart Attributions for details and for how to disable it.
If you have questions about commonly used terms or acronyms, see the Rebuy Glossary.