Skip to main content
Find solutions to common issues with Product Bundles by Appfox. If you don’t see your issue here, contact support@getappfox.com.

​
Widget not showing on product pages

The bundle widget should appear on product pages for products that are part of active bundles. If it’s not showing:

​
Check bundle status

1

Verify bundle is active

Go to Bundles and ensure the bundle status is Active, not Inactive.
2

Confirm product is in bundle

Open the bundle and verify the product is included in the bundle’s product list.
3

Check product inventory

Ensure the product and all other products in the bundle have available inventory.

​
Check theme setup

1

Verify app block is added

  1. Go to Online Store → Themes → Customize
  2. Navigate to a product page
  3. Check if Product Bundles Widget block is present
  4. If not, add it and save
2

Confirm app embed is enabled

  1. In theme editor, click the extensions icon (puzzle piece)
  2. Find Product Bundles in the app embeds section
  3. Ensure the toggle is ON
  4. Save if you made changes

​
Clear cache and test

1

Clear browser cache

Clear your browser cache or open an incognito/private window to see fresh changes.
2

Test with different product

Try a different product page that’s part of an active bundle to rule out product-specific issues.

​
Discount not applying in cart

If customers add bundle products but the discount doesn’t apply:

​
Check bundle requirements

  • Classic/Fixed Bundles: All products must be in cart
  • Mix & Match: Required quantity must be met
  • Volume Discounts: Quantity threshold must be reached
  • BOGO: Trigger product(s) must be in cart

​
Verify product variants

Ensure the exact variants added to cart match those in the bundle:
  1. Check the bundle configuration
  2. Verify product variants are correct
  3. Test with the specific variants from the bundle

​
Check for conflicting discounts

  • Only one discount applies per order (Shopify limitation)
  • If a customer has a discount code applied, it may take precedence
  • Bundle discount should apply if it’s the best available discount

​
Refresh cart

Sometimes cart needs to refresh to recalculate discounts:
  1. Have customer refresh the cart page
  2. Or add/remove an item to trigger recalculation
  3. Discount should appear after refresh

​
Cart banner not appearing

If the cart upsell banner isn’t showing:

​
Verify cart block setup

1

Check cart page for app block

  1. Go to theme editor
  2. Navigate to cart page template
  3. Verify Product Bundles Cart Banner block is added
  4. Save if needed

​
Check trigger conditions

The banner only appears when:
  • Customer has products from a bundle in cart
  • Customer hasn’t added ALL products required for the bundle
  • Bundle is active
Test by adding just one product from a bundle to cart.

​
Preview showing incorrect pricing

If the bundle preview shows wrong prices:

​
Currency format issues

  1. Go to app home page
  2. The app should auto-detect your currency format
  3. If prices look wrong, contact support with your currency details

​
Discount calculation

  • Verify discount percentage or amount is correct in bundle settings
  • Check that all product prices are up to date in Shopify
  • Recalculate by editing and saving the bundle

​
Analytics not showing data

If analytics appear empty or incorrect:

​
Data collection timing

  • Analytics update in near real-time for new orders
  • Historical data may take time to populate
  • Wait 24 hours after first install for meaningful data

​
Check date range

  • Verify you’re looking at the correct date range
  • Try “Last 30 days” instead of “Last 7 days”
  • Check if you have any orders with bundles in that period

​
Order qualification

Orders appear in analytics only if:
  • Customer purchased products from an active bundle
  • Bundle discount was actually applied
  • Order was created after the app was installed

​
Theme compatibility issues

If the app doesn’t work correctly with your theme:

​
Check Shopify 2.0 compatibility

Product Bundles requires Shopify 2.0 theme app block support:
  1. Verify your theme supports app blocks
  2. Update theme to latest version
  3. If using vintage theme, consider upgrading

​
CSS conflicts

If widgets look broken:
  1. Check for CSS conflicts in your theme
  2. Use browser developer tools to inspect element styles
  3. Add custom CSS in app settings to override theme styles
  4. Contact support with screenshots if needed

​
Performance issues

If the app is slow or causing page delays:

​
Check for heavy customizations

  • Remove complex custom CSS temporarily
  • Test with default widget styles
  • Disable other apps one by one to identify conflicts

​
Optimize bundle setup

  • Limit bundles to 2-5 products each
  • Don’t create excessive numbers of active bundles
  • Ensure product images are optimized (not huge files)

​
App not loading in Shopify admin

If the app interface doesn’t load:
1

Refresh the page

Try a hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
2

Check browser compatibility

Use a modern browser: Chrome, Firefox, Safari, or Edge (latest versions)
3

Clear browser data

Clear cookies and cache for Shopify admin
4

Try different browser

Test in a different browser to rule out browser-specific issues

​
Orders not tracking correctly

If bundle orders aren’t appearing in the Orders page:

​
Verify order contains bundle products

  • Check that the order actually includes products from a bundle
  • Verify bundle discount was applied
  • Confirm order was created after app installation

​
Check order date range

  • Orders only show in the selected date range
  • Extend date range or select “All time”

​
Changes not appearing on storefront

If you make changes but don’t see them:
1

Wait a moment

Changes can take 30-60 seconds to propagate
2

Clear cache

Clear browser cache or test in incognito mode
3

Hard refresh

Force refresh: Ctrl+Shift+R or Cmd+Shift+R
4

Check you saved changes

Verify you clicked “Save” in the app after making changes

​
Error messages

​
”Products not found” error

  • Products may have been deleted from Shopify
  • Product IDs may have changed
  • Edit bundle and re-select products

​
”Bundle not active” error

  • Bundle may have been deactivated
  • Go to Bundles page and activate the bundle

​
”Insufficient inventory” error

  • One or more bundle products are out of stock
  • Restock products or edit bundle to remove unavailable products

​
Getting additional help

If you’ve tried these solutions and still have issues:

​
Collect diagnostic information

Before contacting support, gather:
  • Screenshots of the issue
  • URL of affected page(s)
  • Steps to reproduce the problem
  • Any error messages
  • Browser and device information

​
Contact support

Email: support@getappfox.com In-app chat: Click the chat widget in the app Schedule a call: Book a free support call

​
Include in your message

  1. Description of the issue
  2. What you’ve already tried
  3. Screenshots or video if possible
  4. Urgency level (how is this affecting your business?)
Response times:
  • Standard support: Within 24 hours
  • Urgent issues: Within 4 hours during business hours

​
Preventive maintenance

Avoid common issues with these best practices:
Test your bundles after any changes to your theme, other apps, or product catalog.
Enable automatic updates for the app to ensure you have the latest features and fixes.
Check analytics weekly. Sudden drops can indicate configuration issues.
After updating your theme, verify bundle widgets still appear correctly.
Ensure bundle products have adequate stock. Out-of-stock products disable bundles.
Most issues can be resolved by verifying bundle status, checking app block placement, and clearing browser cache. Start with these steps before diving into more complex troubleshooting.