Upsell Widget
The Upsell widget shows the upgrade banner on the product page and the swap card (with undo) in the cart for Upsell campaigns. It is specific to Upsell campaigns.
Updated October 7, 2026
The Upsell widget shows the upgrade banner on the product page and the swap card (with undo) in the cart for Upsell campaigns. It is specific to Upsell campaigns.
Where to Find It
Go to Widgets, then open the Upsell card (or Manage widget settings in an upsell campaign).
📸 [SCREENSHOT: Widgets grid with the "Upsell" card highlighted]
What You Can Configure
Display
| Setting | What It Does |
|---|---|
| Display widget on store | Master on/off switch |
Text customization
| Field | Purpose |
|---|---|
| Default phrasing | Used when a campaign leaves its phrasing blank. {title} and {diff} are replaced automatically |
| No extra cost text | Shown instead of the default phrasing when the upgrade costs nothing extra after the incentive |
| Upgrade button | The cart-card button (default Upgrade) |
| Switch button | The product-page banner button that swaps the cart line (default Switch) |
| Undo text | The undo button on the toast |
| Undo window | How long the undo toast stays (3 to 30 seconds) |
| Swapped toast text | Shown after a swap. {title} is replaced by the new product |
| Error text | Shown on the cart card when the swap fails |
| Dismiss label | Accessibility label of the x button on the cart card |
Colors
Banner and card colors, button colors.
The preview switches between Product page, Cart and After swap, and between states Pays more, No extra cost and Show error. It also replays the toast countdown. All amounts in the preview are samples.
📸 [SCREENSHOT: Upsell widget settings with the cart card preview]
Step-by-Step: Configure the Widget
- Go to Widgets → Upsell.
- Toggle Display widget on store ON.
- Edit the phrasing and button/toast texts.
- Set the undo window and the colors.
- Check each preview state and click Save.
Step-by-Step: Verify It Works
- Confirm you have an active Upsell campaign.
- In an Incognito tab, open a trigger product and confirm the banner shows the real price gap.
- Add the trigger to the cart. Confirm the swap card appears and Switch replaces the line.
- Tap Undo within the window and confirm the original returns.
📸 [SCREENSHOT: Storefront banner and swap toast with Undo]
Tips & Common Mistakes
- Requires an active Upsell campaign. Texts here are defaults, a campaign's own Phrasing template wins when it has one.
- Keep
{title}and{diff}exactly as written. - Use "No extra cost text" if you offer incentives that can fully cover the gap, so the banner never says "only $0.00 more".
- Pick a sensible undo window. Too short and customers can't reverse an accidental swap.
- Requires the app embed to be active.
Mini FAQ
Why doesn't the banner show?
The product isn't a trigger of an active campaign, or the campaign's placement is Cart only.
Does the swap keep the customer's size and quantity?
In Bigger variant mode the customer keeps their other choices. In Better product mode the line is replaced by the upgrade product, so test it on a product with options before launching.
Related Articles
Need a Hand?
Our support team is here to help, reach out anytime at support@aspedan.dev, or use in-app chat.
Last updated: October 2026