How to activate the Bundlex widget in your theme

Your bundle offers only show up on your storefront once the Bundlex widget is turned on in your theme. The quickest way is the Bundlex Bundles card at the top of your dashboard, which opens the Shopify theme editor with the app embed ready to switch on. This guide walks through that card, the two optional blocks you can place by hand, and how to confirm the widget is live.

The Bundlex Bundles card

At the top of your dashboard, the Bundlex Bundles card shows one badge:

• Active (green) means the app embed is on and the widget is being delivered to your product pages.
• Inactive (warning) means the app embed is off, so customers will not see your offers through it yet.

The card tracks the app embed only. If you placed the app block instead (see below), the widget can be live while this badge still says Inactive.

The card reads your theme through Shopify's App Bridge. If you open the app in a standalone browser tab outside Shopify admin, it cannot read your theme and will report the embed as off. 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 Bundlex Bundles card, click Activate.
2. The theme editor opens in a new tab with the embed pre-selected. It is listed under App embeds as Bundlex Bundles.
3. Switch it on, then save your theme.
4. Return to the Bundlex tab. The card refreshes on its own once the change is detected and the badge turns to Active.

The embed shows the widget on product pages and also provides gift cleanup on the cart page. To turn it off later, click Deactivate on the same card, switch the embed off in the theme editor, and save.

The "Bundlex Bundles" app block (manual placement)

The app block 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, then Themes, and click Customize.
2. In the template dropdown at the top, open your Products template.
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. Save your theme.

This block does not affect the product-page widget or the badge on the dashboard card.

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 it above add-to-cart with zero setup? 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 can render twice or behave oddly. Keep one. Before switching to a block, check that it is inside a visible section of the product's actual template. After switching the embed off, reload that product page immediately. If the widget disappears, turn the embed back on and contact support.

For discounts with gifts, prefer the embed because a product-page block alone does not provide its cart-page gift cleanup. An Active badge 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 card shows Active but a product page is still blank, check that a bundle is published and set to show on that product.