--- title: "Setting Up the Free Shipping Upsell" description: "Configure checkout progress and recommendations for a free-shipping threshold." url: https://docs.orderediting.com/en/articles/13808696-setting-up-the-free-shipping-upsell collection: "Placement Setup Guides" updated: 2026-11-03 language: en --- # Setting Up the Free Shipping Upsell Configure checkout progress and recommendations for a free-shipping threshold. # 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 **Upsells**. 2. Select **Create strategy**. 3. Choose **Free Shipping Upsell**, then select **Continue**. 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. > **Warning:** The amount, destination, and currency must agree. Check each market in checkout after changing delivery profiles, currencies, or subscription thresholds. # 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. # Choose how products are shown If the strategy editor shows **Appearance**, select **Customize appearance** to choose how the offer looks. Free Shipping offers four layouts: **Carousel**, **List**, **Product search** and **Threshold only**. In the **List** layout, turn on **Let shoppers reach the rest with arrows** when the strategy usually recommends more products than the list shows at once. Arrows page through the rest of the recommendations and only appear when there are more products to reach. The setting is off until you turn it on, so existing List offers keep their current look. For every appearance setting, including the remaining amount message and catalog search, see [Setting Up Checkout Upsells](/docs/en/articles/13825630-setting-up-checkout-upsells). # 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. # Using a Rewards bar with this offer A **Rewards bar** content block can show checkout progress for subtotal, item quantity or tagged items, with up to three milestones. It is separate from this placement's free-shipping tier and recommendations. Keep the block's targets, strategy tier and actual Shopify shipping rate aligned. Check discounts and each currency when comparing amounts. Neither progress display creates a missing delivery rate. # 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. If you turned on List arrows, confirm they page through the remaining recommendations. 4. Add a recommended product and confirm the progress updates. 5. Cross the threshold and confirm the qualified state. 6. Confirm Shopify shows the expected free delivery option when the cart qualifies. 7. Remove or change an item so the cart moves below the threshold again. 8. Repeat for subscription carts if subscription tiers are enabled. 9. Repeat in every important market and currency. 10. 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 List layout shows no arrows Arrows only appear when **Let shoppers reach the rest with arrows** is on and the strategy has more eligible products than the list shows at once. ## 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. ## Related - [Setting Up the One-Click Upsell](https://docs.orderediting.com/en/articles/14408304-setting-up-the-one-click-upsell.md) - [Setting Up Order Status Page Upsells](https://docs.orderediting.com/en/articles/14429370-setting-up-order-status-page-upsells.md) - [Setting Up Thank You Page Upsells](https://docs.orderediting.com/en/articles/14429369-setting-up-thank-you-page-upsells.md) - [Setting Up Checkout Upsells](https://docs.orderediting.com/en/articles/13825630-setting-up-checkout-upsells.md) - [Send Order Status Page Upsells with Klaviyo](https://docs.orderediting.com/en/articles/15323704-send-order-status-page-upsells-with-klaviyo.md)