The Popup Message component in Smart Flows lets you display a fully customizable modal to shoppers at any point in a flow — from welcome offers and limited-time promotions to cart-threshold messages and post-add upsells. With Product Grid support, you can also surface AI-recommended products or top sellers directly inside the popup, turning every message into a shoppable moment.
Where to find the Smart Flows Popup Message component
In the Smart Flow editor, open the Add Step panel and choose: Messages > Popup Message.
(Screenshot above: Rebuy Admin Smart Flows flow editor showing the "Add Step" panel with the "Popup Message" component highlighted under the "Messages" section)
The Popup Message canvas node appears with the following branches:
Primary Clicked + Pop Up Dismissed — the default configuration when only the Primary Button is enabled.
Primary Clicked + Secondary Clicked + Pop Up Dismissed — appears when the Secondary Button is enabled in the Call To Action section.
Use these branches to chain follow-up steps based on how the shopper interacts with the popup.
Smart Flows Popup Message Settings
A reference for every setting in the Smart Flows Popup Message component, including the Product Grid, Display, Colors, Countdown Timer, Call To Action, and Custom CSS options.
Text settings
The Smart Flows Popup Message Text section contains two always-visible rich text fields with a full formatting toolbar (paragraph style, bold, italic, underline, strikethrough, link, image, HTML edit, and alignment controls).
Title — the main popup heading. Default alignment: center.
Description — supporting body content. Default alignment: center. The Description field also contains the Insert Product Grid icon — see the How to add a Product Grid to a Smart Flows Popup Message section below.
How to add a Product Grid to a Smart Flows Popup Message
The Smart Flows Popup Message Description field includes an Insert Product Grid icon in its toolbar. This lets you embed a live, shoppable product grid directly inside the popup body — no separate widget required.
Click the Insert Product Grid icon in the Description toolbar.
A popover appears with two data source options:
Recommended — AI-powered product recommendations based on the shopper's cart contents, browsing behavior, and customer status.
Top Sellers — products ranked by sales and order data.
Select a data source. The product grid renders inline inside the editor.
Hover over the embedded grid to reveal an edit badge. Click the badge to open the grid's configuration sidebar.
Repeat to add as many product grids as needed — each grid has its own independent settings. You can freely add text content above, below, or between product grids inside the same Description editor.
(Screenshot above: Smart Flows "Popup Message" editor showing the "Description" field toolbar with the product grid icon, and the resulting "Insert product grid" dropdown open with two options: "Recommended (AI)" and "Top Sellers")
Product Grid Configuration options
Each embedded Product Grid has its own configuration sidebar, accessible by clicking the edit badge that appears when hovering over the grid in the Description editor.
(Screenshot above: Rebuy Admin "Popup Message" editor showing a product grid embedded in the "Description" field, highlighting the product grid toolbar icon and the edit badge used to open the product grid's configuration sidebar)
Below are the the settings for the Product Grid Configuration options and what each setting does:
Setting | What it does |
Data Source | Switch between Recommended (AI-powered) and Top Sellers (sales-data-driven). |
Product Limit | Sets how many products appear in the grid. |
Desktop Columns | Column count when the popup container is approximately 768px wide or wider. |
Mobile Columns | Column count when the popup container is narrower than approximately 768px. |
Aspect Ratio | Controls product image proportions. |
Max Height | Caps the product image height. Note: this setting may not be fully functional in the initial release. |
Border Radius (products) | Rounds product card and image corners. |
Button Border Radius | Rounds add-to-cart button corners (pill vs. rectangle). |
Add to Cart Label | Custom text for the add-to-cart button. |
Default to Subscription | Pre-selects the subscription purchase option for eligible products that have an active selling plan and a configured Rebuy Subscription Integration. |
Note: Column breakpoints are based on the container width, not the device screen width. A popup placed in a narrow container will use the mobile column count even on a desktop screen.
Popup Message Product Grid: Use cases
The Product Grid inside a Smart Flows Popup Message is well-suited for a range of promotional scenarios:
Cart-threshold popup: "You're $20 away from free shipping! Here are our top sellers to help you get there." Pair with the Top Sellers data source.
Welcome offer: "Welcome! Here's 10% off — check out what other shoppers love." Pair with the Recommended data source.
Post-add upsell: "Added to cart! You might also like…" Pair with the Recommended data source.
Subscription push: "Save 15% by subscribing." Enable Default to Subscription in the Product Grid configuration sidebar so eligible products pre-select their subscription option.
Display options
The Smart Flows Popup Message Display section controls the visual structure and shape of the Popup Message modal.
(Screenshot above: Rebuy Admin Smart Flows "Popup Message" — "Display" options)
The Smart Flows Popup Message Display options:
Show Backdrop — adds a darkened overlay behind the popup. Off by default.
Make Full-Width — expands the popup to span the full width of the screen. Off by default.
Modal Border Radius — rounds the popup corners. Slider range: 0–50.
Button Border Radius — rounds call-to-action button corners. Slider range: 0–50.
Image Border Radius — rounds image corners inside the popup. Slider range: 0–50.
Note: The Popup Message Display section is intentionally simpler than the Add Items to Cart and Buy X Get Y (BXGY) Display panels. Settings such as Modal Sections Padding, Aspect Ratio, Image Max Height, and Image Layout live within the Product Grid configuration sidebar instead.
Color Customization
The Smart Flows Popup Message Colors section controls the popup's background and text colors.
(Screenshot above: Rebuy Admin Smart Flows "Popup Message" — "Colors" settings section)
The Smart Flows Popup Message Colors options include:
Background Color — sets the popup background. Default: black.
Text Color — sets the popup text. Default: white.
Reset to theme — restores the colors defined in your active Smart Flows theme.
The section header includes a Using Theme: [Theme Name] link that opens the Rebuy theme editor page in a new tab. More details here about the Rebuy Theme Editor page
Countdown Timer settings
The Smart Flows Popup Message Countdown Timer section adds a live countdown to the Popup Message.
(Screenshot above: Rebuy Admin Smart Flows "Popup Message" — "Countdown Timer configuration")
The timer is off by default. When enabled, the following settings become available:
Timer Text (Optional) — a label displayed alongside the timer, such as "Flash Sale Ends In:"
Time Zone — read-only; reflects your shop's configured timezone. Click the link to update it in Rebuy settings.
End Date — the target date in YYYY-MM-DD format. Past dates are disabled.
End Time — the target time in 15-minute increments from 12:00 AM to 11:45 PM.
Timer Position — Top or Bottom of the popup.
Timer Layout — Inline, Stacked, Space Between, or Space Around. Horizontal layouts stack vertically on mobile.
Timer Colors — Background and Text colors for the timer. Defaults: blue background, white text.
Call to Action (CTA) Buttons
The Smart Flows Popup Message Call To Action section controls the buttons displayed inside the Popup Message.
(Screenshot above: Rebuy Admin Smart Flows "Popup Message" — "Call To Action" section showing "Primary Button" and "Secondary Button" options)
The Smart Flows Popup Message Call To Action section configuration options listed below:
Primary Button
The Primary Button is enabled by default and is the only call-to-action pre-enabled in a new Popup Message.
Alignment — Left, Center (default), or Right.
Label — defaults to "Close". Customizable.
The Primary Button dismisses the popup when clicked. Use the Primary Clicked canvas branch to define what happens next.
Secondary Button
The Secondary Button is off by default. Enabling it adds a third canvas branch — Secondary Clicked — so you can chain a separate follow-up step for shoppers who click it.
Label — defaults to "Keep shopping". Customizable.
Note: The Secondary Button does not have an Alignment control. Only the Primary Button alignment is configurable.
Custom CSS
The Smart Flows Popup Message Custom CSS section provides a Monaco editor (dark theme) for advanced styling of the Popup Message component. Click Fill with example CSS to load a starter snippet.
(Screenshot above: Rebuy Admin Smart Flows "Popup Message" — "Custom CSS" section showing the CSS editor and the "Fill with example CSS" button)
Smart Flows Popup Message Limitations
The following limitations apply to the Popup Message component and its Product Grid feature.
Product Grid is exclusive to the Popup Message component. The Product Grid feature is currently available only inside Popup Message nodes. It is not available in other Smart Flows components such as the Website Banner.
Two data sources only. Only Recommended and Top Sellers are supported. Custom or advanced data sources tied to cart state, product detail pages, or customer status are not currently available.
Breakpoint threshold is fixed. The desktop/mobile column switch occurs at approximately 768px container width and cannot be configured.
Preview vs. live differences. The admin previewer may not fully reflect what shoppers see on the storefront. Slight product differences are expected because the live storefront sends a different cart payload than the preview environment.
Save does not auto-refresh the previewer. After saving, manually refresh the preview to see your latest changes.
Frequently asked questions
Can I show product recommendations inside a Smart Flows Popup Message?
Yes. The Smart Flows Popup Message component supports an embedded Product Grid. Click the Insert Product Grid icon inside the Description rich text editor, then choose either the Recommended (AI-powered) or Top Sellers (sales-data-driven) data source.
Can I use the Product Grid in a Smart Flows Website Banner or other component?
No. The Product Grid is currently available only inside the Popup Message component. It is not supported in other Smart Flows components, including the Website Banner.
Can I add multiple product grids to the same Smart Flows Popup Message?
Yes. You can add as many product grids as needed inside a single Popup Message. Each grid has its own independent configuration sidebar, and you can place text content between grids inside the Description editor.
Can I use a custom data source beyond Recommended and Top Sellers in the Popup Message Product Grid?
No, not at this time. Only the Recommended and Top Sellers data sources are supported in the initial release. Context-aware and custom data sources are planned for a future update.
Why does the product grid look different in the Smart Flows previewer compared to my live store?
The Smart Flows previewer does not send the same cart payload that the live storefront sends, so the products returned by the Recommended data source can differ between preview and live environments. To validate the experience accurately, use the Preview Link on a real storefront URL with the ?preview_smart_flow=[id] parameter.
Why aren't my saved Popup Message changes showing up in the preview?
The Smart Flows previewer does not auto-refresh after saving. Manually refresh the page after saving to see your latest changes.
Are the Popup Message Product Grid column counts based on screen width or container width?
Column counts in the Smart Flows Popup Message Product Grid are based on the container width, at approximately 768px. If the popup container is narrow, the mobile column count will be used even on a desktop screen.
Can I default products to subscription in the Popup Message Product Grid?
Yes. Toggle Default to Subscription in the Product Grid configuration sidebar. Eligible products will pre-select their subscription purchase option. The product must have an active selling plan and your Rebuy Subscription Integration must be enabled.