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. You do this from the Theme setup card on your dashboard, which opens the Shopify theme editor for you. This guide walks through the card, the three extensions it manages, and how to confirm the widget is live.

The Theme setup card

On your dashboard, find the Theme setup card and click its header to expand it. At a glance, the card shows whether the widget is reaching your storefront:

• Widget active (green) means the bundle widget is being delivered to your product pages.
• Widget inactive (warning) means it is not, so customers will not see your offers yet.

Next to that status you will see a count, such as 2 of 3 active, showing how many of the three extensions are currently switched on.

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 everything as off. Always check this status from inside Shopify admin.

The three extensions

Expanding the card reveals three rows. Each row has its own Active or Inactive badge and a button that opens the theme editor in a new tab.

Bundlex embed (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. In the Theme setup card, on the Bundlex embed row, click Activate.
2. The theme editor opens with the embed ready to enable.
3. Enable the embed, then save your theme.
4. Return to the Bundlex tab. The dashboard refreshes the status on its own once the change is detected.

The embed targets the product page template, so it appears on product pages only. To turn it off later, use the Deactivate button on the same row.

Bundlex app block (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. Because you choose the spot, placement is manual.

1. On the Bundlex app block row, click Add.
2. In the theme editor, add the block to a section on your product page where you want the widget to appear.
3. Save your theme.

To remove it, click Remove on that row. The editor opens to your product template, but you will need to find the block in the section list and remove it there.

Bundlex featured product

The featured product block is a marketing block, not a product-page widget. It pairs with Shopify's Featured product section, conventionally on your homepage, to promote a chosen product together with its bundle offers.

1. On the Bundlex featured product row, click Add.
2. In the theme editor, add the block to the Featured product section.
3. Save your theme.

This block does not affect the product-page widget status. Whether it is on or off, it does not change the Widget active badge.

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.

When neither is on, the embed row is highlighted as the recommended next step to get your widget live.

Avoid the Redundant badge

If you turn on both the embed and the app block, the dashboard shows a Redundant badge next to the widget status. Both paths deliver the same bundle widget, so running both can render it twice on the page. Only one is needed. Remove either the embed or the block to clear the badge and avoid duplicate rendering.

Still not seeing the widget?

Turning on a theme extension 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 Theme setup card shows Widget active but a product page is still blank, check that a bundle is published and set to show on that product.