Troubleshooting Common Issues

Solve the most common bundle problems in under 2 minutes with these step-by-step fixes.

Bundle Not Showing on Store

Most common cause: Theme integration not enabled.

Quick fix:

1. Go to Online Store > Themes in your Shopify admin
2. Click "Customize" on your active theme
3. Navigate to App embeds (usually in the sidebar)
4. Find "Bundle Widget" and toggle it ON
5. Save your theme

Still not working? Check bundle status in the Uppa app - it should show "Active" not "Draft".

Wrong Discount Amounts

Symptoms: Prices don't match your configured percentages or show incorrect savings.

Most common causes:

• Variant pricing differences - Bundle calculates from the specific variant price, not the base product price
• Existing Shopify discounts - Other active discounts can interfere with bundle calculations
• Currency formatting - Display settings may round prices differently than expected

Quick fixes:

1. Check variant prices - View the exact product variant the customer selected
2. Review active discounts - Temporarily disable other automatic discounts to test
3. Verify tier settings - Ensure percentages are entered correctly (15% = 15, not 0.15)

Bundle Showing on Wrong Products

Symptoms: Bundles appear on products you didn't intend or don't appear where expected.

Most common cause: Product selection settings in bundle configuration.

Quick fix:

1. Open the bundle in edit mode
2. Check "Apply to products" section
3. Verify your selection:
   • "All products" shows everywhere
   • "Specific collections" only shows on products in those collections
   • "Specific products" only shows on individually selected products

Mobile Display Issues

Symptoms: Bundle looks good on desktop but broken or hard to use on mobile.

Quick fixes:

1. Switch to compact spacing in customization settings
2. Use center alignment for better mobile appearance
3. Test font sizes - smaller screens may need adjusted typography
4. Check button sizes - ensure they're large enough for touch interaction

Mobile-specific tip: Always test changes on an actual mobile device, not just browser dev tools.

Slow Loading or Performance

Symptoms: Bundle widget takes time to appear or slows down product pages.

Most common causes:

• Multiple bundles with overlapping product selections
• Complex tier structures with many pricing options
• Heavy customization with many display elements enabled

Quick fixes:

1. Reduce bundle overlap - Avoid having multiple bundles on the same products
2. Simplify tier structures - Most effective bundles use 2-3 tiers maximum
3. Hide unnecessary elements - Show only the pricing information customers need

Styling Conflicts with Theme

Symptoms: Bundle widget looks out of place or overrides theme styles incorrectly.

Quick fixes:

1. Match theme colors - Use your theme's primary colors in bundle customization
2. Adjust spacing - Switch between compact/standard/spacious to find best fit
3. Test font settings - Ensure text remains readable with your theme's background

Advanced solution: Contact support for specific theme compatibility - some themes need custom integration.

Orders Not Tracking Properly

Symptoms: Bundle sales not appearing in analytics or discounts not applying at checkout.

Most common cause: Checkout integration timing.

Quick fix:

1. Test with real purchases - Some analytics only track completed orders
2. Check discount codes - Bundle discounts are automatic, not code-based
3. Verify order details - Look for bundle information in Shopify order details

Getting More Help

If these solutions don't solve your issue:

1. Document the specific problem - Note exactly what you expect vs. what happens
2. Include screenshots - Visual context helps support resolve issues faster
3. Use in-app chat - Faster than email for troubleshooting sessions
4. Test in incognito mode - Eliminates browser cache issues

Before contacting support: Try the relevant fix above first - they resolve 85% of issues immediately and get you back to selling faster.