The widget isn't showing on my product page

If the Bundlex widget isn't appearing on a product page, it's almost always one of three things: the app isn't switched on in your theme, no published bundle targets that product, or the product falls outside the bundle's "Show widget on" filter. Work through the checks below in order and you'll usually find the cause in a minute or two.

Quick checklist

Before digging into details, confirm all three of these are true:

• The Bundlex app embed (or app block) is enabled in your theme editor.
• The bundle is Published.
• The product you're viewing falls within that bundle's Show widget on filter.

If any one of those is off, the widget won't render. Here's how to verify each.

Step 1: Confirm the app is enabled in your theme

Bundlex delivers the widget through your theme in one of two ways, and you only need one of them turned on:

• App embed - a single toggle that injects the widget on product pages automatically.
• App block - a section block you place manually in the product template.

To check the app embed:

1. In Shopify admin, go to Online Store → Themes.
2. Click Customize on your live theme.
3. Open the App embeds panel (the puzzle-piece icon in the left sidebar).
4. Find Bundlex and make sure its toggle is on.
5. Click Save.

If you placed the widget as an app block instead, open the product template in the theme editor, look for the Bundlex block in the section list, and confirm it's present and not hidden.

You can check the app's delivery status at a glance from the Bundlex dashboard under Theme setup. It shows whether the embed, app block, or featured product block is active. If neither the embed nor the app block is active, you'll see a warning there.

Step 2: Confirm the bundle is published

A bundle only powers a storefront widget once it's published. Open your bundle in the Bundlex dashboard and confirm its status is Published. A draft or paused bundle will not show on any product page, even if the app embed is on.

Step 3: Confirm the product is in the bundle's filter

Each bundle has a Show widget on rule that decides which products display it. The options are:

• All products
• Selected products
• All except selected products
• Collections

Open the bundle and check that the product you're testing actually matches the rule. A common cause of a "missing" widget is a bundle set to Selected products where the product in question was never added, or a Collections rule pointing at a collection the product doesn't belong to.

Step 4: Read the browser console

If the three checks above all pass and the widget still isn't there, the storefront can tell you exactly what's happening. The widget logs diagnostic messages to the browser console, all prefixed with [Bundlex].

1. Open the product page in your browser.
2. Open developer tools (press F12, or right-click the page and choose Inspect).
3. Switch to the Console tab.
4. Reload the page and look for any line starting with [Bundlex].

What the messages mean

A healthy load looks like this:

[Bundlex] Widget initialized successfully

If you see one of the messages below instead, here's what to do:

Warnings (rather than errors) such as Variant container not found, Buy button not found, or Quantity container not found are non-fatal. They're expected on single-variant products or when you've hidden the quantity selector, and they don't stop the widget from showing.

The selectors map

A successful init also prints a debug object that includes a selectors map. Each entry is marked with a check (found) or a cross (not found) for a DOM element the widget looks for:

• quantityInput - the quantity field
• quantityContainer - the quantity wrapper
• addToCartButton - the Add to cart button
• buyButton - the Buy it now button
• productFormContainer - the product form
• variantsContainer - the variant pickers

If a critical selector such as productFormContainer is marked as not found, the widget can't anchor itself to your theme's product form, which leads to the Product form not found error above.

Custom selectors for non-standard themes

Most themes follow Shopify's standard markup and work out of the box. Some heavily customized or third-party themes use non-standard structure, so the widget can't find the form or the quantity input on its own. For those cases, the Bundlex app embed settings let you supply custom selectors that point the widget at the right elements, including:

• a custom product form selector
• a custom quantity input selector (also useful when a theme has duplicate quantity inputs, for example a sticky add-to-cart bar that repeats the form)

You'll find these in the theme editor under App embeds → Bundlex. If you're not sure which selector to use for your theme, contact support with the product page URL and we'll help you find the right one.

Still not showing?

If you've worked through every step and the widget is still missing, send support the following so we can reproduce it quickly:

• The product page URL.
• Any [Bundlex] lines from the browser console (errors in particular).
• A screenshot of the product page.