Main Reasons Why the Free Shipping Upsell Is Not Rendering on Your Website
If your Free Shipping Upsell is not appearing on your store, don’t worry — in most cases, the issue is related to a simple setting, theme configuration, or display condition. This article covers the most common reasons why the upsell may not be rendering and how to fix them quickly 🚀
1. The App Embed Is Not Enabled 🎨
For the Free Shipping Upsell to display correctly, the app embed must be enabled in your theme.
How to check:
- Go to Shopify Admin → Online Store → Themes
- Click Edit theme on your active theme
- Open App embeds
- Make sure the Essential Free Shipping Upsell is enabled
- Click Save
If the app embed is disabled, the upsell will not render at all.
2. The Upsell Is Not Published 🚫
Even if everything is set up correctly, the upsell will not appear unless it is published.
What to check:
- Open the Essential Free Shipping Upsell app
- Make sure your upsell campaign is active / published
- If it’s in draft mode, click Publish
3. Display Rules Are Preventing the Upsell from Showing 👀
Display rules determine where and under what conditions the Free Shipping Upsell is displayed.
What to check:
-
Placement settings
Make sure the correct placement is selected:
- Product page — the upsell will only appear on product pages
-
Cart page — the upsell will only appear on the cart page
If the placement does not match the page you are viewing, the upsell will not be displayed.
Custom position setup 📍
If Custom position is selected:
- The upsell will not render automatically
- You must add the app block in the Theme Editor
-
Make sure the correct Booster ID is selected in the app block
If the app block is missing or the Booster ID is incorrect, the upsell will not appear.
-
Country targeting 🌍
If country targeting is enabled, the upsell will only be displayed to visitors from the selected countries.
If you are testing the upsell from a country that is not included in the targeting rules, it will not be shown.
To learn more, please refer to this guide:
👉 How to use geolocation targeting on the Essential Free Shipping Upsell app
Make sure your current location is included in the allowed country list.
Review these settings carefully to ensure the upsell is allowed to appear in the current scenario.
4. Theme or App Conflicts ⚠️
Some themes or third-party apps (especially cart drawers, custom carts, or checkout-related apps) can interfere with rendering.
Possible causes include:
- Custom AJAX cart implementations
- Cart replacement apps
- Heavy theme customizations
In these cases, the upsell may not load.
Still Not Showing? We’re Here to Help 💙
If you’ve checked everything above and the Free Shipping Upsell is still not rendering, our support team is happy to investigate.
Please contact us at support@essential-apps.com and include:
- Your store URL
- A brief description of the issue
We’ll take a closer look and help you get everything up and running as quickly as possible 🚀