# Troubleshooting

Use this guide when something does not look right.

## Bundle Is Not Showing on the Storefront

Check:

1. **Theme integration is set up**:
   * For **Build Your Own Bundle**: Ensure **Bundle Builder** app embed is enabled in **Online Store > Themes > Customize > App embeds**.
   * For **Multi-Option Bundle**: Ensure **Multi-Option Bundle** app block is added to the product template in the theme editor.
2. The bundle status is **Active** or **Unlisted**.
3. You are viewing the correct bundle product page or dedicated bundle page.
4. The theme was saved after enabling the theme integration.

If the settings page shows a failed setup service, contact support.

## Bundle Opens but Products Are Missing

Check:

* Each step has products or a collection selected.
* Products are active in Shopify.
* Products have available variants.
* Collection-based steps contain products.
* Products have images if the design expects images.

## Customers Cannot Add the Bundle to Cart

Check:

* Required steps have selected products.
* Quantity limits are not impossible to satisfy.
* Products and variants are in stock.
* The bundle product is not in draft.
* The storefront preview works on both desktop and mobile.

## Discounts Are Not Applying

Check:

1. Discount tiers are configured.
2. The cart qualifies for a tier.
3. The bundle was added through the bundle page.
4. The app settings page does not show a failed discount service.
5. You tested in checkout, not only on the product page.

Contact support if checkout still does not show the discount.

## Bundle Looks Wrong After Changing Template

Changing templates can reset the design. Reopen the design editor and review:

* Layout
* Colors
* Product grid
* Button styles
* Discount display
* Mobile view

## Theme Changes Broke Bundle

After changing or publishing a theme:

1. Reopen the theme editor.
2. Confirm the theme integration is set up on the new live theme.
3. Save the theme.
4. Preview an active or unlisted bundle.

Theme integrations are theme-specific, so a new live theme may need to be set up again.

## Analytics Are Missing or Delayed

Check:

* The bundle has had real storefront traffic.
* The bundle page was loaded after the app setup completed.
* The settings page does not show a failed web pixel service.
* You are viewing the correct date range or bundle.

Some analytics may take time to appear.

## Still Need Help

Open the app and click **Support** or **Chat now**. Include:

* Store domain
* Bundle name
* Bundle URL
* What you expected
* What happened instead
* Screenshots, if available


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.elitebundleapp.com/help-and-support/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.