How to activate the Bundlex Bundles widget in your theme

Your bundle offers only show up on your storefront once the Bundlex Bundles widget is turned on in your theme. Start on the app's dashboard inside Shopify admin. The status button next to the Overview title shows whether the widget is on, and its Turn on button opens the Shopify theme editor with the app embed ready to switch on. This guide walks through that button, the two optional blocks you can place by hand, and how to confirm the widget is live.

▶ Watch tutorial · 1:37

The widget status button

At the top of your dashboard, next to the Overview title, a status button shows one of two states:

• Widget on means the app embed, the product page block or the featured block is on. A published deal must also target the product before its offers can appear.
• Widget off means none of them is on, so customers will not see your offers yet. A Turn on button appears beside it.

Click the status button to see each part. The App embed row has a Turn on or Turn off button that opens the theme editor in a new tab. The Product page block and Featured block rows show Added, or a Not used line that says what the block is for (a custom spot; other pages, like home), with a How to add link. While the setup guide is open, its first task, Turn on the app embed, has an Activate button that opens the same theme editor page.

If you placed the app block instead of the embed (see below), the button reads Widget on and the App embed row says the embed is not needed with the product block.

The status button reads your theme through Shopify's App Bridge. If you open the app in a standalone browser tab outside Shopify admin, it cannot reliably read the current theme status and may show Widget off or a previously remembered status. Always check this status from inside Shopify admin.

The "Bundlex Bundles" app embed (recommended)

This is the simplest option and the one we recommend. The app embed automatically inserts the bundle widget above the add-to-cart button on your product pages, so there is nothing to place by hand.

To turn it on:

1. On the dashboard, click Turn on beside Widget off, or open the status button and click Turn on in the App embed row.
2. The theme editor opens in a new tab with the embed pre-selected. It is listed under App embeds as Bundlex Bundles.
3. Check that you are editing the theme you intend to use. Switch Bundlex Bundles on, then click Save.
4. Return to the Bundlex Bundles tab. The status refreshes on its own once the change is detected and the button reads Widget on.

The embed shows the widget on product pages and also provides gift cleanup on the cart page. To turn it off later, open the status button and click Turn off in the App embed row, switch the embed off in the theme editor, and save.

The "Bundlex Bundles" app block (manual placement)

▶ Watch tutorial · 1:25

The app block needs a theme section that supports app blocks. It is an alternative to the embed. Use it when you want the widget somewhere other than above the add-to-cart button, for example below the product description or inside a product tab. You place it directly in the theme editor:

1. In your Shopify admin, go to Online Store and click Edit theme.
2. In the template dropdown at the top, open the Products template assigned to the product you are testing.
3. Pick the section where you want the widget, click Add block, open the Apps tab, and select Bundlex Bundles.
4. Drag the block to the spot you want, then save your theme.

To remove it later, open the same product template, find the block in the section list, and remove it there.

The "Bundlex Bundles featured" block

The featured product block is for your home page or a landing page, not the product page. It goes inside Shopify's own Featured product section, which supplies the add-to-cart button, and the block adds the bundle offers to it:

1. In the theme editor, open the home page or the page template you want.
2. Click Add section and choose your theme's Featured product section, then pick the product with the offer.
3. Inside that section, click Add block, open the Apps tab, and select Bundlex Bundles featured.
4. Open the Bundlex Bundles featured block settings and check its Product. If it is connected to Section Product, it already follows the section. Otherwise, select the same product as the Featured product section. Keep the section's buy button present.
5. Save your theme and open the actual page to check the offer and add-to-cart result.

This block does not affect the product-page widget. The dashboard lists it in the status button's Featured block row, and this block alone is enough for the button to read Widget on.

Either the embed or the block is enough

The product-page widget is delivered if either the embed or the app block is on. You do not need both. Pick whichever placement fits your store:

• Want automatic placement above add-to-cart? Use the embed.
• Want it in a specific spot you control? Use the app block.

Do not run both

If you turn on both the embed and the app block, the widget initializes once, but its placement and settings can come from whichever loads first. This can leave it in the wrong place or apparently frozen. Keep one. Test a placement change in a draft theme first. Add the block to a visible section of the product's actual template and confirm that it renders. Then switch off the embed in that draft, save and reload its product preview to check the block on its own. If the widget disappears, restore the embed and contact support. Keep the published theme working while you test; a draft theme does not change the live storefront until you publish it.

For discounts with gifts, prefer the embed because a product-page block alone does not provide its cart-page gift cleanup. A Widget on status or an enabled block is not a substitute for checking the live product page.

Still not seeing the widget?

Turning on the embed or placing the block is only half of the setup. For offers to appear on a given product, you also need a published bundle whose targeting includes that product. If the dashboard shows Widget on but a product page is still blank, check that the App embed or the Product page block is on, and that a bundle is published and set to show on that product.

Check the live result after a theme change

Open a product that your active deal targets, select an offer and add it to the cart. Check that one widget appears and the intended products and quantities arrive. A draft-theme preview is not the same as your published storefront. When you publish a different theme, recheck its embed or block setup.

Need an example deal to test? Create quantity breaks or a single-product and complete-bundle choice.