Design
Upsell Design tab - layout, decline, widgets, and product blocks for checkout UI vs post-purchase.
The Design tab configures how an upsell looks on the storefront. Controls differ by surface:
| Surface (merchant) | Design surface | Typical home |
|---|
| Thank You / account checkout UI | Checkout UI | Thank You page offers |
| Post-purchase page (interstitial) | Post-purchase | Shopify post-purchase app |
Mark Post-purchase only rows carefully - those controls do not appear on Thank You Design.
| Panel | Fields | Checkout UI | Post-purchase |
|---|
| Callout banner | Title, Body (localized + variables) | - | Yes (Shopify-required top banner) |
| Progress bar | Show; Style (minimal / minimal labels / maximal); Appearance (light / dark) | Yes | Yes |
| Field | Options | Notes |
|---|
| Orientation | Horizontal, Vertical, Shelf | Shelf only on Checkout UI |
| Mobile columns | One / Two | Multi + non-shelf on Checkout UI |
| Field | Checkout UI | Post-purchase |
|---|
| Style | Button / Link | Button / Link |
| Label | Editable (localized; empty → default) | Locked (“Decline offer”) - style only |
| Widget | Fields | Checkout UI | Post-purchase |
|---|
| Text | Heading, Body, Alignment, Size | Yes | Yes |
| Image | Image URL, Alt, Alignment, Width | Yes | Yes |
| Text & Image | Heading, Body, Image URL, Image position | Yes | Yes |
| Extra buy button | Info only (Shopify-prescribed label) | - | Yes (single-product) |
| Trust badge | Image size; badge item children | Yes | Yes |
| Trust badge item | Image URL, Caption | Yes | Yes |
| FAQs | Q/A list | Yes | Yes |
| Timer | See below | Yes | Yes |
| Testimonials | Quote / author; layout | Yes | Yes |
| Field | Post-purchase | Checkout UI |
|---|
| Duration (minutes) | Yes | - |
| Label | Localized | Localized |
| On expiry | Decline offer and continue / Hide the timer | - |
| Progress bar | - | Switch |
| Block | Fields | Checkout UI | Post-purchase |
|---|
| Product image | Size, Border | Yes | Yes |
| Title | Show vendor | Yes | Yes |
| Price | Savings text | - | Yes |
| Variants | Show selector; Preselect (smart / first available / none); Show sold-out | Yes | Yes |
| Quantity | Enabled; preset (none / fixed / % of purchased / minimum / maximum) | Yes | Yes |
| Shipping | Free / Priced (+ price) | - | Yes |
| Price breakdown | Info only (Shopify-required) | - | Yes |
| Buttons | Button label | Yes | - |
| Buttons | Require confirmation; Supporting text | - | Yes |
| Block | Fields |
|---|
| Badge | Label; Style (filled / outline) |
| Star rating | Rating 0-5; Review count (0 hides count) |