Rebuy Widget Types

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.

Rebuy widgets are defined by three separate settings, and understanding the difference explains why several differently-named widgets behave the same way in reporting.

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.

Rebuy's theme and pop-up widgets, such as the home page, product page, cart page, and classic account page widgets in this article, are created on the Create New Widget page, which opens when you click Create New on the Widgets page. The Widgets page opens from Cart & Merchandising and then Widgets in the Rebuy admin sidebar, or from a single Merchandising Widgets entry on some plans. Pick the widget you want on the Create New Widget page, and Rebuy asks you to choose its location afterwards. Checkout Extensions, the Post Purchase Widget, and Bundle Builder are not created on the Create New Widget page, and each one's section below links its own setup guide. Widget Dashboard Page: Create a Widget and Manage the Ones You Have covers the full steps, the Your Widgets table, and how to duplicate or delete a widget.

The goal buttons on the Create New Widget page are a broader version of the Choose a widget by goal table in this article, not a different set of goals. Clicking a goal button hides the widget cards that are not tagged with that goal, while the Choose a widget by goal table maps an individual merchandising job to the widget that handles it and links that widget's setup guide. Use the table when you already know the job you need done, and the goal buttons when you are browsing the Create New Widget page.

This table maps common merchandising goals to the widget or tool that handles them. Each linked article covers full setup.

Home and collection page widgets surface product recommendations at the top of the shopping journey, before a customer reaches a specific product.

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.

Home Page Cross-Sell setup guide

The Collection Page Widget displays product recommendations on collection pages, helping shoppers discover additional products while browsing.

Collection Page Widget setup guide

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.

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.

AI Recommendation setup guide

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 Cross-Sell setup guide

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 Upsell setup guide

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.

Add to Cart Subscription Upsell setup guide

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.

Product Add-Ons Widget setup guide

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.

Dynamic Bundle Widget setup guide

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 shoppers choose which gifts they claim, use the Selectable Gift with Purchase widget, a separate Rebuy widget type covered in the section "Selectable Gift with Purchase Widget" below.

Gift With Purchase Widget setup guide

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.

Buy More Save More Product Page Widget: Overview

Developer reference: Buy More Save More custom template

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. A Selectable Gift with Purchase widget created at the Cart location also appears inside the Smart Cart, and the section "Selectable Gift with Purchase Widget" below covers it at every location it supports.

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.

How to Create a Cart Cross-Sell Pop-Up Widget

The Cart Cross-Sell (Embedded) widget displays product recommendations as an embedded section directly inside the Smart Cart, with no pop-up.

How to Create an Embedded Cart Cross-Sell 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.

Pre-Purchase Popup Widget setup guide

The Cart Page Widget displays product recommendations as an embedded section directly inside the standard Shopify cart page, rather than inside the Smart Cart.

Cart Page Widget setup guide

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.

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.

Checkout Extensions setup guide

Thank You Page and Order Status Page Product Recommendations

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.

Content Block setup guide

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.

Checkout Extensions setup guide

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.

Progress Bar setup guide

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.

Rebuy Monetize setup guide

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.

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.

Post Purchase Widget setup guide

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.

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: Install a Rebuy Widget on Shopify 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 a widget card on the Create New Widget page that offers Account Page as a location, such as Buy it Again, with Account Page chosen as the location. This is the older method, and a widget built this way renders only while your store stays on classic customer accounts.

Account Page Widgets on Classic Customer Accounts

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.

Bundle Builder setup guide

Developer reference: Bundle Builder custom template

Developer reference: Bundle Builder event listeners

The Tabbed Recommendations Widget displays multiple curated product sets in one widget, organized into tabs that shoppers click between, with each tab pulling from its own independent data source, showing its own maximum number of products, and carrying its own column and carousel layout.

Tabbed Recommendations Widget setup guide

The Selectable Gift with Purchase widget lets shoppers choose which free or discounted gifts they claim once their cart subtotal reaches a spending milestone you set. The Selectable Gift with Purchase widget is its own Rebuy widget type, separate from the Gift With Purchase Widget, and you create it on the Create New Widget page with no custom code.

A Selectable Gift with Purchase widget can be created at the Cart location, where it appears inside the Rebuy Smart Cart drawer, at the Product Page location, where it appears below the Add to Cart button, or at the Global location, where shoppers can reach it from any page as a floating gift icon or a pop-up modal. The location is chosen when the widget is created and cannot be changed afterwards. Only a Cart-location Selectable Gift with Purchase widget needs Rebuy's Smart Cart, and it appears on your storefront only after you add it to your Smart Cart in the Smart Cart editor. Product Page and Global Selectable Gift with Purchase widgets need a placement in your Shopify theme, such as the Rebuy Widget app block.

Each milestone in a Selectable Gift with Purchase widget sets an Unlock Price and how many gifts the shopper can claim, and every gift the widget's data source returns is available at each unlocked milestone. Gifts claimed from a Selectable Gift with Purchase widget are recorded under their own attribution value, Rebuy Selectable Gift with Purchase.

Selectable Gift with Purchase Widget: Let Shoppers Choose Their Free Gift

These Rebuy tools personalize the storefront but are not tied to a single page widget the way the widgets above are.

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 Search setup guide

Developer reference: Smart Search Quick View custom template

Developer reference: Smart Search Results Page custom template

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 Collections setup guide

Developer reference: Smart Collections custom templates

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 Flows setup guide

Developer reference: Smart Flows methods

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.

Smart Links setup guide

Developer reference: Smart Links URL structure and methods

Landing page widgets create personalized pages that you link to from email or SMS campaigns.

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.

Reorder Landing Page setup guide

The Reactivate Landing Page is a personalized page that re-engages lapsed customers by presenting their previous purchases and prompting them to buy again.

Reactivate Landing Page setup guide

Rebuy widgets can be installed on third-party order tracking pages to surface product recommendations at post-purchase touchpoints.

The Malomo Widget displays Rebuy product recommendations on Malomo order tracking pages.

Malomo Widget setup guide

The Wonderment Widget displays Rebuy product recommendations on Wonderment order tracking pages.

Wonderment Widget setup guide

The Passport Widget displays Rebuy product recommendations on Passport-powered pages.

Passport Widget setup guide

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.

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.

Exit Intent Popup Widget setup guide

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.

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.

The Gift With Purchase Widget writes Rebuy Gift with Purchase and the Selectable Gift with Purchase widget writes Rebuy Selectable Gift with Purchase, so an order can tell those gift features apart.

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.

Two details affect how you read these values:

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.

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.

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.

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.

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 shoppers choose which gifts they claim, use the Selectable Gift with Purchase widget, a separate Rebuy widget type that can be placed in the Smart Cart, on the product page, or across your whole store.

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.

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.