Troubleshooting
Common issues
Bundle isn't showing on the storefront
The most common causes are the App Embed or Widget Block not being set up, the bundle being in DRAFT or ARCHIVED status, or the product not being linked to the bundle.
Check the setup guide on the Radius Bundles dashboard. Step 1 (Turn on the app embed) and step 3 (Add the bundle widget) show whether the App Embed and Widget Block are active. If either shows as incomplete, click Check status to confirm. Also open the bundle in the Bundles list and check that its status is ACTIVE, and that the product page you're testing is linked to the bundle.
To fix:
- Enable the App Embed:
Online Store → Themes → Customize → App embeds → Radius Bundles → toggle on → Save. - Add the Widget Block: in the theme editor, navigate to a product page →
Add block → Apps → Radius Bundles → drag to position → Save. - Change the bundle status to
ACTIVEfrom the bundle list.
Discount didn't apply at checkout
The discount only applies when all required bundle products are in the cart at the correct quantities, the bundle is ACTIVE (not PAUSED or DRAFT), and the cart meets any minimum order value you set. A maximum discount cap can also bring the saving down to nothing.
Check that all bundle products are in the cart at the required quantities. Open the bundle's Discount step to check for a minimum order value or maximum cap. Confirm the bundle's status in the Bundles list.
To fix:
- Add all required products at the correct quantities before checking out.
- Remove the minimum order value or discount cap if they're unintentional (the bundle's Discount step, Limits card).
- Activate the bundle if it was accidentally paused.
If the discount still isn't applying with everything in the cart, go to Settings → Tools → Sync to Shopify and run a sync, then test again.
Bundle discount is turned off in Shopify
Shopify treats the Radius Bundles discount as an automatic discount. If someone deactivates it in the Shopify admin (Discounts section), no bundle discount applies at checkout, even though prices still show correctly in the widget.
A red banner reading "Bundle discounts are turned off in Shopify" appears at the top of the dashboard, the bundle list, the bundle editor and Settings.
To reactivate, click Reactivate discount on the banner. Or go to Settings → Tools and click Sync to Shopify. Sync detects the deactivated discount and reactivates it automatically. The sync result dialog reports what it did.
If the discount was deleted in Shopify rather than turned off, the banner reads "The bundle discount was deleted in Shopify" instead. Click Recreate discount, or run Sync to Shopify.
If neither works, go to Discounts in your Shopify admin, find the discount named "Radius Bundle Discounts - DO NOT DELETE", and reactivate it manually. Then run a sync to confirm.
Scheduled bundle didn't go live
The bundle activates on a background check that runs on a schedule. If the start date has passed and the bundle is still SCHEDULED, the check hasn't run yet.
Open the bundle in the Bundles list. Dates are in your shop's timezone. If the status shows ACTIVE but the discount isn't applying, go to Settings → Tools → Sync to Shopify and run a sync (see Sync to Shopify), then test checkout. If the status still shows SCHEDULED more than 24 hours after the start date, contact support. Include the bundle name and the start date you set.
Changes don't appear on the storefront
The storefront may be serving cached data. Check Settings → Advanced → Refresh bundle data on the storefront. If it's set to 1 hour, changes can take that long to appear. Open the product page in an incognito window to rule out a local cache. The theme editor preview can also show old data while the live storefront is already up to date.
To push changes immediately: go to Settings → Tools → Clear caches, then Settings → Tools → Sync to Shopify. Reload in an incognito window.
If changes still don't appear, check that you saved the theme editor. Unsaved theme editor changes don't persist.
Widget styling looks broken or unstyled
The most likely causes are custom CSS with an error, or theme CSS overriding the widget.
Start by disabling custom CSS: go to Settings → Advanced, clear the CSS field and save. If the widget looks normal after that, the CSS is the problem. If you're comfortable with browser dev tools, inspect the widget element for unexpected display: none or visibility: hidden styles.
To fix:
- Edit or remove the custom CSS in
Settings → Advanced → Custom CSS. - If theme CSS is overriding the widget, add a custom class in
Settings → Advancedand use it as a higher-specificity selector. - Run
Settings → Tools → Sync to Shopifyto push the latest styles.
Cart count or cart drawer doesn't update after adding a bundle
Usually the bundle went into the cart fine, and your theme just didn't redraw its cart when an app added to it.
Reload the page. If the cart now shows the bundle, the add worked and only the display was out of date.
Check Theme cart compatibility. If your theme is listed but the cart still doesn't update, contact support with your theme name and version (Online Store → Themes). If it's not listed, send the page to your theme developer. It describes a short script that fixes the issue.
In the meantime, set Settings → General → After "Add to cart" to Go to the cart so shoppers see their updated cart straight away.
The setup guide won't mark a step as complete
Step 1 (Turn on the app embed): The check calls the Shopify Theme API, which can return stale data if you have many themes or a recently installed one. Click Check status again after a minute. If it still doesn't complete, toggle the app embed off and back on in the theme editor.
Step 3 (Add the bundle widget): The step auto-completes when the app detects the widget block in your active theme. If it doesn't complete after saving the theme editor, click Check status.
Other steps: Steps 2, 4, 5 and 6 complete on their own as you use the app, for example when you create your first bundle or open Analytics. If a step doesn't complete, the detection may be delayed. Reload the dashboard.
Try fewer words, look in the FAQ, or ask the team.