The Single Product module shows one specific product in an upsell strategy. Use it when you know exactly which product you want customers to see.
When to use it
Use Single Product for focused offers where the product choice should not change automatically.
- A universal add-on, such as gift wrap, warranty, insurance, or care instructions.
- A high-margin product you want to promote across many orders.
- A campaign product with specific creative or offer copy.
- A replacement, refill, or accessory targeted with strategy filters.
Before you begin
Make sure the product is active, available in the online store, and not excluded by Hidden Products. If the product has variants, decide whether all variants should appear or only selected variants.
Warning: If the selected product or every selected variant is hidden, sold out, or unavailable online, customers won't see the offer.
Setup steps
- Open the upsell strategy you want to edit.
- In the Product modules section, click Add Module.
- Select Single Product.
- Click Select a product and choose the product you want to offer.
- If the product has variants, click Manage in the Product Variants section to limit which variants can appear.
- If you select variants, choose the highlighted variant. This variant is pre-selected for the customer.
- Set the Recommended Quantity.
- Write Offer Text. Use
$productNameif you want the product name inserted automatically. - Click Save.
Configuration options
Option | What it controls | Recommended approach |
Selected product | The exact product customers can add. | Choose a product that is easy to understand without browsing. |
Product variants | Which variants are eligible for the offer. | Restrict variants when size, color, or availability matters. |
Highlighted variant | The variant pre-selected for customers. | Pick the safest default or the highest-converting variant. |
Recommended Quantity | The quantity suggested when the product appears. | Use 1 for most add-ons. Increase it only for multi-pack offers. |
Recommended settings
Scenario | Recommendation |
Universal add-on | Use broad strategy filters and keep quantity at 1. |
Consumable refill | Use product or collection filters so the offer appears after relevant purchases. |
Variant-specific offer | Select only eligible variants and highlight the most common variant. |
Checkout Page offer | Enable Show quantity selector only if customers should choose more than one. |
Where this module is strongest
Single Product is strongest when the product is easy to understand without comparison. It works well for warranties, gift wrap, accessories, samples, limited drops, and high-margin add-ons.
It is weaker when the right recommendation depends on what the customer bought. In that case, use Complementary Products, Related Products, Metafields, or a filtered strategy.
How to make the offer feel relevant
Use strategy filters to control who sees the product. For example, offer shoe care only when the order contains footwear, or offer a refill only when the order contains the matching product line.
If the product has variants, restrict the module to variants that make sense for the offer. Highlight the safest default variant so the customer doesn't need to decide from scratch.
Troubleshooting
The product doesn't appear
Check that the product is active, published to the online store, and not hidden by your Hidden Products query. Also check that selected variants are available.
The wrong variant is selected
Open the module, go to Product Variants, and choose the highlighted variant. If no variant is highlighted, Order Editing uses the first eligible variant.
The customer can't change quantity
On Checkout Page and Free Shipping Upsell placements, open quantity settings and enable Show quantity selector. On other placements, make sure Hide quantity selector is not enabled.
