How to add Upsells
How to add Upsells
ConvertX Upsells let you offer additional products directly on the product page using a simple checkbox system.
When the customer checks the upsell and clicks the theme’s Add to Cart button, the upsell product is automatically added to the cart.
Upsells are designed to be:
Simple
Non-intrusive
Easy to understand for customers
How Upsells work
An upsell is displayed as a product card with a checkbox.
If unchecked → nothing happens
If checked → the product is added to cart together with the main product
Upsells use the theme’s native Add to Cart button.
They are usually placed above the Add to Cart button to keep the buying flow natural.
Upsell editor overview
The Upsell editor is split into two main areas:
Left panel
Tabs:
General
Upsell
Style
Right panel
Live preview of the upsell card
All changes are instantly reflected in the preview.
General tab
The General tab defines where the upsell is displayed.
General information
Upsell name
Internal name used inside ConvertX.Where should the upsell be displayed
All products
Specific products
Specific collections
If you choose specific products or collections, you must select them manually.
Upsell tab
The Upsell tab defines what product is offered and how it is presented.
Product to highlight
Select the product you want to offer as an upsell
This product will be added to the cart when checked
Custom content
You can customize:
Custom product name
Upsell description
Badge text (for example: Perfect Combo)
Show or hide the product image
Pre-select the upsell by default (optional)
Pre-selecting an upsell should be used carefully to avoid confusing customers.
Style tab
The Style tab lets you fully customize the upsell design.
You can adjust:
Product title typography
Description typography
Price and compare-at price
Badge style and colors
Checkbox colors
Border and frame colors (normal and hover)
Match the upsell design with your theme for a seamless experience.
Publish the upsell
Once your upsell is ready, click Publish upsell.
After publishing:
The upsell is saved
It is not automatically displayed on product pages
Add the upsell to a product page
Like Stories, Upsells must be added manually using an App Block.
Click “Add to a product page”
After publishing, click Add to a product page.
Open the Theme Editor
You are redirected to the Shopify theme editor.
Add the ConvertX App Block
On the product page:
Add an App Block
Select ConvertX Upsell
Place the upsell correctly
Place the upsell above the Add to Cart button.
Save changes
Click Save.
Placing the upsell above the Add to Cart button ensures a smooth and non-disruptive experience.
Upsells are added to the cart only when:
The checkbox is checked
The customer clicks the theme’s Add to Cart button
The upsell does not replace the main product and does not trigger a separate add-to-cart action.
Common issues
Check that:
The upsell is published
The App Block is added to the product page
You are viewing a targeted product
The theme changes are saved
Make sure:
The checkbox is checked
The theme’s Add to Cart button is used
The upsell product is available and in stock
Best practices
Offer complementary products only
Use clear and short descriptions
Avoid too many upsells on one page
Place upsells above the Add to Cart button