Upsell product settings
Every setting on the Upsell product widget: discount, shipping, image, buttons, price breakdown, product details, variants, and layout.
The Upsell product widget is the heart of an offer — the product, its price, and the buttons the customer uses to accept or decline.
Where to find it: in the offer editor, click Upsell product in the widget list (or one of the shortcuts under it). Its settings are grouped into collapsible sections; one is open at a time.
Discount
| Setting | Options | Default |
|---|---|---|
| Automatic Discount | A number, plus % Off or [your currency] Off (for example USD Off). | 15 % Off |
| Discount title | Text. | Empty |
| Use 'compare at' price | Checkbox. | On |
- No discount? Set Automatic Discount to
0. - Discount title appears as small grey text under the price on the real post-purchase page, and names the discount on the order. Leave it empty and the order shows the discount as
15% off(or Offer discount for an amount). - Use 'compare at' price shows the price before your discount, crossed out. It is not your product's compare-at price from Shopify. The default Product price text already shows the crossed-out price with
{original-price}, so this setting only makes a difference if you clear that text.
Amount-off discounts apply once per line
A percentage discount applies to every unit. An amount-off discount comes off the whole line once. With $10 Off and a quantity of 3, the customer saves $10 in total, not $30.
Shipping
| Setting | Options | Default |
|---|---|---|
| Shipping type | Free shipping, Flat rate, or Calculated at checkout | Free shipping |
| Shipping rate | Amount charged for shipping. Flat rate only. | 0 |
| Charge per unit | Multiply the shipping rate by the quantity ordered. Flat rate only. | Off |
- Free shipping adds no shipping charge for the upsell.
- Flat rate adds a real shipping charge to the order, shown to the customer as Shipping.
- Calculated at checkout is a label only — the app adds no shipping charge.
Image
| Setting | Options | Default |
|---|---|---|
| Main image size | Slider, 200–600 | 400 |
| Add border around main image | Checkbox | Off |
| Custom product image | Upload, under Show advanced image settings | None |
A Custom product image replaces the product's own image in the offer. Uploads are saved to your store's Content → Files. You can replace an uploaded image, but not remove it.
Buttons
Accept button
| Setting | Options | Default |
|---|---|---|
| Require confirmation click to accept | Checkbox. The first click changes the button to Confirm to pay; the second click accepts. | Off |
| Default accept button text | Pay Now or Accept Offer | Pay Now |
| Button language | 21 languages | English |
The accept button always shows the total — for example Pay Now · $24.00.
Button language translates the accept text, Decline this offer, and Confirm to pay into the language you choose. It applies to every customer who sees this offer, whatever language they shop in.
Decline button
| Setting | Options | Default |
|---|---|---|
| Style | Secondary (a button) or Link | Link |
The decline text is always Decline this offer, in the chosen Button language.
Layout
| Setting | Options | Default |
|---|---|---|
| Buttons positions relative to each other | Accept above decline, Decline above accept, or Accept beside decline | Accept above decline |
| Alignment | Stack to right side or Full width | Stack to right side |
| Text above buttons | Rich text | Empty |
| Text under buttons | Rich text | Empty |
Full width moves the buttons below the image and product details. In a single-column layout the buttons are always full width. Both text fields accept variables like {discount} and {product}.
Price breakdown
| Setting | Default |
|---|---|
| Show shipping and tax breakdown | On |
| Show extra details in breakdown (subtotal, discount, etc.) | On |
| Show free shipping in breakdown | On |
| Alignment — Stack to right side or Full width | Stack to right side |
| Position in offer — Above payment buttons or Bottom of the widget | Above payment buttons |
The breakdown lists Subtotal, Discount, Shipping, Taxes, and Total. Turn off the extra details to show only the Shipping row. Taxes are calculated by Shopify on the real page and don't appear in the editor preview.
Product details
| Setting | Default |
|---|---|
| Show quantity selector | On |
| Skip offer if product is in original order | Off |
| Product title | {product} in bold |
| Product price | {original-price}{current-price} {savings} (savings in green) |
| Offer description | Don't miss out on this offer... it expires after you leave this page! |
- The quantity selector lets the customer choose 1–50.
- Skip offer if product is in original order skips the offer entirely when any variant of its product is already in the order. The customer moves on as if the slot were empty.
Don't combine skip with cart-based offers
Most expensive item in cart and Least expensive item in cart always offer a product that's already in the order. Turn on Skip offer if product is in original order for one of those, and the offer never shows.
Product title, Product price, and Offer description are rich-text fields. See Text and variables.
Variants
| Setting | Options | Default |
|---|---|---|
| Show all out of stock variants | Checkbox. When off, sold-out variants are left out of the dropdowns. | Off |
| Hide product when out of stock | Checkbox. Skips the offer when every variant is out of stock. | Off |
| Show variant options that have only one available choice | Checkbox | On |
| Variant selector position | Above pricing data, Above CTA buttons, or Below CTA buttons | Above pricing data |
| Variant selector top padding / bottom padding | Slider, 0–10 | 0 |
| Hide variant selector | Checkbox, under Show advanced variant settings | Off |
- The quantity box moves together with the variant selector.
- Hide variant selector stops customers switching variants — use it only when the offer should be a single, fixed variant. The out-of-stock check under Hide product when out of stock doesn't run while the selector is hidden.
Layout
| Setting | Options | Default |
|---|---|---|
| Layout preference | Two column or Single column | Two column |
| Max layout width | Slider, 600–1200 | 850 |
| Top padding / Bottom padding | Slider, 0–10 | 4 / 0 |
Two column puts the image on the left and the details on the right. Single column stacks everything, and is what mobile always uses. Changing the layout resets both Alignment settings above.
Next
Widgets — the timer, text, images, trust badges, and FAQs around the product.