How do I display Bundles on my qualifying products?

The Bundles Block is designed to display promotions tied to "Buy X Get Y" discounts when specific conditions are met. This block enhances the shopping experience by providing clear visibility of the promotion directly on the matching products' page.




Adding the Bundles Block in BlockLab


In your admin system, click BlockLab in the main menu.



On the BlockLab page you will see your various layouts available to edit. In this case, Related Products is a product page specific element, so we need to access the Product Page.

Now you will be in the BlockLab design area for your Product Page. We need to add the Bundles block, so click the Block Tab in the menu at the top, then click New to reveal the Blocks Menu.

In the bottom row of blocks available, you will see an array of product specific Blocks that are available to use. Click Bundles.


This will add the block on your product page design. Use the move controls to position the Block where you want it to appear, then double-click it to configure its settings.

Features and Settings of the Bundles Block

You can double-click on the Bundles Block to access and customise its settings. 

  1. Change the Heading:

    • Modify the heading text displayed at the top of the block.

  2. Add Custom Product Text:

    • Insert custom HTML or Twig code to provide additional promotional details to the product card.


  3. Edit the Icon’s HTML:

    • View and customise the HTML for the icon displayed within the block.



  4. Colour Picker for Quantity Badge:

    • Use the colour picker to change the colour of the quantity badge, ensuring it aligns with your website's branding.

  5. Edit Text and Add to Basket Button:

    • Customise the text and "Add to Basket" button using HTML and Twig. This allows for advanced styling and personalised messaging.

  6. Image Aspect:

    • Adjust the image aspect ratio for product visuals displayed in the block.

When Does the Bundles Block Appear?

The Bundles Block will display under the following conditions:

  1. Buy X Get Y Discount is Configured:

    • The discount must be set up as a "Buy X Get Y" type.

  2. Products in the "Buy" Section:

    • The "Buy" section must return only one product per line item that meets the criteria.

    • Example: The block will display for "Buy 3 iPhone 14 Pro Max" but not for "Buy 3 Apple products" (since the latter includes multiple product lines).

  3. "All Matching Items" in the "Get" Section:

    • The "Get" section must be configured to apply the discount to "All Matching Items" only.