> ## Documentation Index
> Fetch the complete documentation index at: https://bundles-docs.getappfox.com/product-bundles/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Product page widget

> Add the Bundles (product page) app block to a Shopify product template so active bundles, variant choices, and add to cart appear on the product page.

The product page widget displays your active bundles on product pages, allowing customers to see bundle options and add bundled products to their cart with one click.

## What is the product page widget?

The product page widget is a Shopify theme app block that shows bundle offers on product pages. When a customer visits a product page for any product that's part of an active bundle, the widget displays the bundle information and an "Add to cart" button.

## Adding the widget to your theme

**1. Open the theme editor**

Go to **Online Store** → **Themes** in your Shopify admin, then click **Customize** on your active theme.

**2. Navigate to a product page**

In the theme editor, use the page selector at the top to navigate to a product page template (usually "Product" or "Default product").

**3. Add the app block**

Click **Add block** in the product template section. Scroll to the **Apps** section and select **Bundles (product page)**. This block only appears on product templates. To show one bundle on another page, such as the homepage, use the **Single bundle (any page)** block instead (see [Bundles page and Single bundle block](https://bundles-docs.getappfox.com/product-bundles/docs/storefront/bundles-page-and-block.md)).

**4. Position the widget**

Drag the widget block to your desired position on the page. Common placements:

* Below the product description
* Above the "Add to cart" button
* In a separate section after product details

**5. Save your changes**

Click **Save** in the top right corner of the theme editor.

## Widget behavior

![Fixed bundle widget with Blue Snowboard and Red Gloves, each showing 4.7 (12)](https://mintcdn.com/appfox-bundles/JvgX2FNik22wHOl8/product-bundles/docs/images/20-product-page-widget.png?fit=max\&auto=format\&n=JvgX2FNik22wHOl8\&q=85\&s=970ac0752232ed44f8dc070f1784b4f0)

### When the widget appears

The widget displays only when:

* The current product is part of at least one active bundle
* The bundle products have available inventory
* The app embed is enabled

If these conditions aren't met, the widget doesn't appear (no empty state shown).

### Multiple bundles

If a product is part of multiple active bundles:

* All applicable bundles are shown
* Customers can choose which bundle to add
* Each bundle has its own "Add to cart" button

### Widget display for different bundle types

**Classic and Fixed Bundles**:

* Shows all products in the bundle
* Displays original price and bundle price
* Shows total savings
* "Add bundle to cart" button adds all products

On the product page of a Classic bundle or a bundle sold as its own product, the same block lists the products included in the bundle. It does not add a second add-to-cart button for those products.

**Mix & Match Bundles**:

* Shows product selection grid
* Quantity selector (e.g., "Choose 5")
* Selected products counter
* "Add to cart" button (enabled when requirement is met)

**Volume Discounts**:

* Shows quantity threshold (e.g., "Buy 3 or more, save 20%")
* Quantity selector
* Price per unit (before and after discount)
* "Add to cart" button

**BOGO Bundles**:

* Shows trigger product(s) and reward product(s)
* Discount on reward products
* Total pricing with discount
* "Add bundle to cart" button

## Checkbox add-ons

You can offer optional products inside the bundle widget. Customers choose add-ons with checkboxes before adding the bundle to their cart.

**1. Choose add-on products**

Create or edit a bundle. In **Checkbox add-ons and personalisation**, click **Select add-on products** and choose products from your catalog. The search covers your whole catalog. You can select up to 50 products. Each add-on uses the first available variant of its product.

**2. Customize each add-on**

Set its title and optional subtitle. You can replace the product image with an HTTPS image URL or clear the image field. Choose **No discount**, **Percentage off**, **Amount off**, or **Final price**. Enter the discount value when needed.

**3. Set the default selection**

Enable **checked by default** for any add-on you want preselected. Customers can uncheck it. Save the bundle when you finish.

Each checked add-on adds one item to the cart together with the bundle. Unchecked add-ons are excluded, and unavailable add-ons cannot be selected. An add-on discount applies only while the qualifying bundle items from that cart addition are present. Purchasing the add-on on its own does not qualify for that discount.

In the bundle's design controls, use **Upsells** to customize the add-on background, border, text, and price colors. Add-on revenue and savings are included in the parent bundle's Orders and Analytics totals.

If your store serves more than one language, go to **Settings** > **Translations**, choose the bundle, and translate each add-on's title and subtitle. A translation stays with its add-on product when you remove or reorder other add-ons.

### Charge for personalisation

Use a checkbox add-on to sell engraving, monogramming or any custom text for a fee.

**1. Create a fee product**

In Shopify, create a product priced at your fee (for example, "Engraving" at \$5.00) and add it as a checkbox add-on.

**2. Ask for text**

Enable **asks for personalisation text** on that add-on. Set the **field label** (for example, "Engraving text"), the **character limit** (up to 500), and whether the text is **required**.

When customers tick the add-on, a text field appears under it. The fee is added as its own cart line, and the text is saved on that line under your field label, so you see it on the order. If the field is required and empty, the customer is asked to fill it in before anything is added to the cart.

## Personalisation fields

Collect a name, message or choice with a bundle, such as an engraving, gift note or wrap colour.

**1. Add a field**

Create or edit a bundle. In **Personalisation fields**, click **Add personalisation field**. You can add up to 10 fields.

**2. Choose the type and settings**

Pick **Text**, **Text area**, **Dropdown** or **Checkbox**. Set a label (shown to the customer and used as the property name, so each label must be unique) and a placeholder. Text and text area fields also have a character limit of up to 500. For a dropdown, enter one option per line. Turn on **Field is required** to stop customers adding the bundle until they fill it in.

**3. Save the bundle**

Customers see the fields in the bundle widget, above the add to cart button.

Answers are saved as line item properties on every line of the bundle, so they show in the cart, at checkout and on the order. A checked checkbox is saved as **Yes**; unanswered optional fields are left out. If a required field is empty, the widget shows an inline message and does not add the bundle to the cart.

Personalisation fields aren't available for bundle products (see [Bundle as a product](https://bundles-docs.getappfox.com/product-bundles/docs/bundles/bundle-as-a-product.md)), because their pages don't show the bundle widget. For Classic bundles, the fields appear in the widget on the pages of the products inside the bundle, not on the Classic bundle's own product page.

To translate field labels, placeholders and dropdown options, go to **Settings** > **Translations** and choose the bundle.

## Widget settings

Configure the widget appearance in the theme editor:

### Block settings (in theme editor)

* **Widget position**: Top, middle, or bottom of product page
* **Container width**: Full width, centered, or custom
* **Spacing**: Padding above and below the widget

### Global style settings (in Product Bundles app)

Go to **Settings** in the app to customize:

* Colors (background, text, button)
* Button style and text
* Font choices
* Border and shadow effects

Changes apply to all widgets across your store.

### Per-bundle customization (optional)

When creating or editing a bundle:

1. Go to the **Style** tab
2. Override global settings for this specific bundle
3. Save changes

Use per-bundle styles for:

* Seasonal or promotional bundles with unique branding
* Testing different visual approaches
* Special bundles that need distinctive appearance

## Customizing widget appearance

### Colors

Match your store's branding:

* **Background color**: Widget container background
* **Text color**: Product names and descriptions
* **Price color**: Original and discounted prices
* **Button color**: Add to cart button background
* **Button text color**: Add to cart button text

### Button text

Customize the button text:

* Default: "Add bundle to cart"
* Examples: "Get this deal", "Shop the bundle", "Add all to cart"
* Keep it short and action-oriented

### Layout options

Some themes support additional layout options:

* Horizontal vs. vertical product layout
* Image size (small, medium, large)
* Show/hide product prices
* Show/hide savings amount

Check your theme documentation for available options.

## Best practices

> [accordion] Place widget prominently
>
> Position the widget where customers will see it without scrolling too far. Above the fold or just below the main product info works well.

> [accordion] Match your store design
>
> Use colors and styles consistent with your theme. The widget should feel like a natural part of your store, not an add-on.

> [accordion] Keep button text clear
>
> Use action-oriented language that clearly indicates what happens when clicked. "Add to cart" is universally understood.

> [accordion] Show value prominently
>
> Make sure the savings amount is visible. Customers should immediately see "Save \$X" or "X% off".

> [accordion] Test on mobile
>
> After adding the widget, check how it looks on mobile devices. Adjust settings if needed for mobile optimization.

> [accordion] Don't overcrowd
>
> If you have many bundles on one product, consider limiting to 2-3 most relevant bundles to avoid overwhelming customers.

## Widget on different page types

### Standard product pages

Widget appears on all standard product pages where products are in active bundles.

### Quick view / product modals

Widget behavior in quick view depends on your theme. Some themes support app blocks in quick view, others don't.

### Collection pages

Widget typically doesn't appear on collection pages (only on individual product pages). Use collection page banners or featured sections to promote bundles.

## Troubleshooting

**Widget not appearing**:

1. Verify the product is part of an active bundle
2. Check that the app block is added in theme editor
3. Ensure the app embed is enabled (Online Store → Themes → App embeds)
4. Confirm products have available inventory
5. Clear browser cache and check in incognito mode

**Widget appears but looks broken**:

* Check for theme conflicts (try with a default theme)
* Verify no custom CSS is interfering
* Contact support if issue persists

**Widget position is wrong**:

* Go to theme editor
* Find the **Bundles (product page)** block
* Drag it to the desired position
* Save changes

**Multiple widgets appearing**:

* Check that you haven't added the block multiple times in theme editor
* Remove duplicate blocks

> [!TIP]
>
> The widget is fully responsive and works on all devices. Test your widget on desktop, tablet, and mobile to ensure a great experience across all screen sizes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.