Choose a recommendation source
The Nosto component supplies products for an upsell strategy using your connected Nosto account. Connect Nosto in Order Editing before adding the component. If it is not connected, select Set up Nosto integration in the component settings.
Source | What it uses | Availability |
|---|---|---|
Query recommendations | Best sellers, most viewed products, or related products. | Existing Nosto recommendation behavior. |
Manual cart recommendation slot | A cart recommendation slot configured in Nosto, evaluated using the current checkout cart. | New Nosto components in eligible Product List Upsell (Checkout) and Free Shipping Upsell strategies. Requires the matching app block in Shopify's checkout editor. |
Manual slots do not use earlier browsing history. They do not add Nosto add-to-cart or purchase attribution. If you need those capabilities, discuss your setup with Support before choosing this source.
Query recommendation settings
Open your upsell strategy, add Nosto, and choose a Recommendation Type. If Recommendation source is shown, keep Query recommendations selected.
Setting | What it controls |
|---|---|
Best Sellers (by purchases) | Products ranked by purchases. |
Most Viewed Products | Products ranked by views. |
Related Products | Products related to the current order or cart products. |
Time Period (hours) | The activity window. The default is 168 hours. |
Maximum Products | The maximum number of recommendations, from 1 to 20. |
API Token (Module Override) | Appears on older components with their own token. Clear it to use the central Nosto connection. |
Set your offer text and select Save. Save the strategy to retain the change.
Use best sellers for broad appeal, most viewed products for browsing demand, and related products when you want Nosto to choose related items. Shopify-powered product sources remain available when you do not maintain a Nosto recommendation setup.
Configure a manual cart slot
Before choosing this source, confirm that your central Nosto connection has an Apps API token permitted to run campaign session requests. Use a cart recommendation slot from your Nosto account. Compatibility with Nosto's separate native Shopify Checkout Page campaign type must be checked for your setup.
- Open a strategy whose Checkout placements are Product List Upsell, Free Shipping Upsell, or both.
- Add a new Nosto component.
- Set Recommendation source to Manual cart recommendation slot.
- Enter the cart slot identifier in Nosto slot ID. Enter it exactly, without spaces before or after it.
- Set Maximum Products and your offer text.
- Select Save, then save the strategy.
Configure campaign rules in Nosto. Consider a Nosto fallback such as best sellers, and check its results in checkout. Order Editing does not list campaigns for you or provide an arbitrary query editor.
Existing Nosto components keep their current behavior. To migrate, remove the component and add Nosto again. If new adoption later becomes unavailable, saved manual-slot components retain their settings and can still run on their saved placements. Adding a new placement requires eligibility again.
Check the result
Test Connection checks the Nosto integration. For a manual slot, it does not validate the slot identifier, its permissions, or the recommendations it returns.
Confirm that the matching Product List Upsell (Checkout) or Free Shipping Upsell app block is installed in Shopify's checkout editor. Add products to the cart and continue to checkout. Change products and quantities to check the recommendations. For Free Shipping Upsell, also check carts below, at and above your shipping threshold. Existing threshold and product eligibility rules still determine which offers appear. You do not need to place an order.
Manual-slot recommendations require customer processing permission. They can return no products when permission is unavailable, the cart is empty, the slot has no eligible results, the connection fails, or recommended products are unavailable in Shopify. A checkout-editor preview alone does not prove live targeting.
Resolve common issues
What you see | What to check |
|---|---|
Nosto integration required | Complete the central Nosto setup, then return to the component. |
Manual slot is not offered | Confirm eligibility, supported checkout placements, and a newly added component. Checkbox Upsell, Thank You, Order Status and followup components do not support manual slots. |
Connected but no recommendations found in query mode | Check the recommendation type, time period and Nosto recommendation data. |
A manual slot shows no products | Check the exact slot ID, token permissions, campaign rules, processing permission and Shopify product availability. |
Maximum Products shows an error | Enter a number from 1 to 20. |
If the issue continues, give Support the strategy, slot ID, test time and the checks you completed. Do not send API tokens or customer details.
