Setting Up the Free Shipping Upsell

Before you begin

• Shopify Plus is required to add checkout app blocks.
• Confirm the store has a clear free-shipping threshold for each market and currency you will use.
• Confirm the products are active and available in the required markets.
• Decide whether the strategy should use global free-shipping tiers or a supported strategy override.

The Free Shipping Upsell shows how far a cart is from free shipping and recommends products that can close the gap. After the threshold is reached, the placement can show its configured normal offer behaviour.

Create the strategy

1. Open Upsell Strategies.
2. Select Create Strategy > Create from scratch.
3. On Placements, choose Free Shipping Upsell for the Checkout.
4. Confirm Placement, select Markets, enter an Upsell Strategy Name, and select Draft while you install and test the placement.
5. Under Customer Segment, keep All customers or add targeting filters.
6. Complete SHIPPING with the intended free-shipping tiers.
7. Complete FILTER to control which products can be recommended.
8. Add or review the product module used for recommendations.
9. Configure supported offer, quantity, and advanced options.
10. Select Publish to save the strategy as Draft.

Configure free-shipping tiers

Global tiers are managed under App Settings > Global settings > Shipping Recalculation > Global free shipping tiers. Each tier has a destination, name, currency, minimum cart value, and optional subscription behaviour.

Strategies use global tiers by default unless they have a supported override. If Shopify delivery profiles contain the source thresholds, you can import detected tiers and review them before saving.

Choose recommended products

Use Smart Recommendation for automatic available-bestseller recommendations that help close the gap. Use another module shown by the editor when you need a controlled product or product pool.

The product filter should avoid products that cannot reasonably be purchased in the current market or that exceed the intended offer design. Hidden-product, inventory, restriction, and market rules still apply after the module returns candidates.

If no eligible products remain, the progress message can still be affected by the placement configuration, but the strategy cannot display a product recommendation that the customer cannot buy.

Install the placement

1. Select Open checkout editor from the placement setup.
2. Confirm you are editing the published Checkout page.
3. In the Delivery section, select Add app block.
4. Search for Order Editing.
5. Add Free Shipping Upsell.
6. Review the block's checkout-editor settings and placement.
7. Select Save.
8. Return to Order Editing and confirm the Free Shipping surface is Active.

Check it in checkout and activate

1. Create a test cart below the threshold in a selected market.
2. Confirm the block shows the correct currency, amount remaining, and recommendations.
3. Add a recommended product and confirm the progress updates.
4. Cross the threshold and confirm the qualified state.
5. Confirm Shopify shows the expected free delivery option when the cart qualifies.
6. Remove or change an item so the cart moves below the threshold again.
7. Repeat for subscription carts if subscription tiers are enabled.
8. Repeat in every important market and currency.
9. Set the reviewed strategy to Active and monitor impressions, paid upsells, and revenue.

You do not need to complete the order. The cart and checkout show the threshold, recommendations, qualified state, and Shopify delivery options before payment.

Troubleshooting

The block does not appear

Confirm Shopify Plus, the saved Free Shipping Upsell app block, strategy status, Checkout placement, market, and targeting.

The threshold is wrong

Check whether the strategy uses global tiers or an override. Then review destination, currency, minimum cart value, subscription behaviour, and any recent delivery-profile change.

No products appear

Check the module configuration and product filter. Then check market availability, inventory, hidden products, restrictions, and whether the products can be purchased in checkout.

The cart already qualifies for free shipping

The customer is in the qualified state, so a “remaining amount” prompt is no longer needed. Review the placement's configured behaviour after qualification.

Shipping is not free on the final order

The progress tier and Shopify's actual delivery rate must agree. Confirm Shopify or the carrier app returns a free rate for that cart and destination. The upsell progress bar does not create a missing carrier rate by itself.