> For the complete documentation index, see [llms.txt](https://docs.elitebundleapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elitebundleapp.com/help/troubleshooting.md).

# Troubleshooting

Troubleshoot Shopify bundle display, products, add to cart, discounts, theme embed, analytics, and setup issues in Elite Bundle Builder.

Find the symptom, run the checks in order.

## The bundle is not showing on the storefront

{% stepper %}
{% step %}

### Check the app embed

**Online Store → Themes → Customize → App embeds**: **Elite Embed Core** must be on for the *live* theme, and the theme saved afterwards.
{% endstep %}

{% step %}

### Check the status

The bundle must be **Active** or **Unlisted**.
{% endstep %}

{% step %}

### Check the URL

Open the bundle's own product page or its dedicated page, not a different product.
{% endstep %}

{% step %}

### Check setup status

On [App settings](/get-started/settings.md#setup-status), no service should show **Failed**. If one does, contact support.
{% endstep %}
{% endstepper %}

## The bundle opens but products are missing

* Every step has products or a collection
* The products are active in Shopify and have available variants
* Collection-based steps contain products
* Products have images if the design expects them

## Shoppers cannot add the bundle to cart

* Required steps have products selected
* Quantity limits can actually be satisfied
* Products and variants are in stock
* The bundle product is not a draft
* Test on mobile as well as desktop

## The cart does not list what is inside the bundle

* **Elite Embed Core** settings: **Show the products inside a bundle under its cart line** is on
* The bundle was added as one line (Cart Transform on); with a third-party checkout the products are separate lines and there is nothing to list
* Standard themes need no setup. On a custom theme or a side-cart app, inspect one cart line and put its wrapper class in **Cart page line item selector** and **Cart drawer line item selector**, such as `.cart-item`
* Toggle shows but in the wrong spot: put the class of the element it should follow in **Place after**, such as `.cart-item__price`

Step by step in [How the app finds the cart line](/customize-and-publish/publish-on-storefront.md#how-the-app-finds-the-cart-line).

## Discounts are not applying

* Tiers are configured in the **Offer** tab
* The cart qualifies for a tier
* The bundle was added from the bundle page, not as separate products
* You tested in checkout, not only the product page
* The settings page does not show a failed discount service

## The bundle looks wrong after changing template

Picking a template overwrites the layout settings with that template's values (branding, variant display and quick view are kept). Open **Design** and review Product card & variants, Steps, Bundle cart and Discount display, then check mobile width.

## A theme change broke the bundle

{% hint style="warning" %}
App embeds are per theme. After publishing a new theme: open the theme editor, enable **Elite Embed Core** on the new live theme, save, then preview an active or unlisted bundle.
{% endhint %}

## The upsell card does not show

* **Show upsell** is on in **Config → Upsell** and the bundle is saved
* The bundle is **Active** or **Unlisted**
* The product page matches **Where to show** and is not the bundle's own page
* **Placement** does not say **Off**; if it does, turn on **Elite Embed Core**
* On a custom theme without a standard Add to cart button, add the **Bundle Upsell** app block

## Analytics are missing or delayed

* The bundle has had real storefront traffic
* The settings page does not show a failed web pixel
* You are looking at the right bundle and range

Some activity takes a little time to appear.

## Still stuck?

Open the app and click **Support** or **Chat now**. Include the store domain, bundle name and URL, what you expected, what happened, and a screenshot if you have one.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.elitebundleapp.com/help/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.