> ## Documentation Index
> Fetch the complete documentation index at: https://bundles-docs.getappfox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Solve common issues with Product Bundles

Find solutions to common issues with Product Bundles by Appfox. If you don't see your issue here, contact [support@getappfox.com](mailto: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

<Steps>
  <Step title="Verify bundle is active">
    Go to **Bundles** and ensure the bundle status is **Active**, not **Inactive**.
  </Step>

  <Step title="Confirm product is in bundle">
    Open the bundle and verify the product is included in the bundle's product list.
  </Step>

  <Step title="Check product inventory">
    Ensure the product and all other products in the bundle have available inventory.
  </Step>
</Steps>

### Check theme setup

<Steps>
  <Step title="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
  </Step>

  <Step title="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
  </Step>
</Steps>

### Clear cache and test

<Steps>
  <Step title="Clear browser cache">
    Clear your browser cache or open an incognito/private window to see fresh changes.
  </Step>

  <Step title="Test with different product">
    Try a different product page that's part of an active bundle to rule out product-specific issues.
  </Step>
</Steps>

## 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

<Steps>
  <Step title="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
  </Step>
</Steps>

### 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:

<Steps>
  <Step title="Refresh the page">
    Try a hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
  </Step>

  <Step title="Check browser compatibility">
    Use a modern browser: Chrome, Firefox, Safari, or Edge (latest versions)
  </Step>

  <Step title="Clear browser data">
    Clear cookies and cache for Shopify admin
  </Step>

  <Step title="Try different browser">
    Test in a different browser to rule out browser-specific issues
  </Step>
</Steps>

## 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:

<Steps>
  <Step title="Wait a moment">
    Changes can take 30-60 seconds to propagate
  </Step>

  <Step title="Clear cache">
    Clear browser cache or test in incognito mode
  </Step>

  <Step title="Hard refresh">
    Force refresh: Ctrl+Shift+R or Cmd+Shift+R
  </Step>

  <Step title="Check you saved changes">
    Verify you clicked "Save" in the app after making changes
  </Step>
</Steps>

## 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](mailto:support@getappfox.com)

**In-app chat**: Click the chat widget in the app

**Schedule a call**: [Book a free support call](https://calendar.app.google/W24SGtLPk3K23VMK7)

### 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:

<AccordionGroup>
  <Accordion title="Regular testing" icon="vial">
    Test your bundles after any changes to your theme, other apps, or product catalog.
  </Accordion>

  <Accordion title="Keep app updated" icon="arrows-rotate">
    Enable automatic updates for the app to ensure you have the latest features and fixes.
  </Accordion>

  <Accordion title="Monitor analytics" icon="chart-line">
    Check analytics weekly. Sudden drops can indicate configuration issues.
  </Accordion>

  <Accordion title="Test after theme updates" icon="paintbrush">
    After updating your theme, verify bundle widgets still appear correctly.
  </Accordion>

  <Accordion title="Review inventory regularly" icon="boxes-stacked">
    Ensure bundle products have adequate stock. Out-of-stock products disable bundles.
  </Accordion>
</AccordionGroup>

<Tip>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.</Tip>