# Products bundle

<figure><img src="https://3026705042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAJrvmfqcj9TMoPkl3bNc%2Fuploads%2FI5dfDTgdWNehDLjXf5rS%2FHyper%20docs%20screenshot%20do%20not%20delete%20(46).jpg?alt=media&#x26;token=48a9884c-b604-4b9a-8d28-fcc7e617dc6d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This design is available from :sparkles:version 1.1.0 and above. :sparkles:

See: [changelog](https://docs.foxecom.com/hyper-theme/changelog "mention")
{% endhint %}

The **Products Bundle** section allows you to display a featured product image with optional hotspot tags, alongside a list of bundled products customers can add to cart with one click.

* Hotspots highlight products on image hover (desktop) or scroll to the product (mobile).
* Customers can choose variants before adding the bundle to the cart.
* Perfect for seasonal sets, starter kits, or curated collections.

## How to add a Products bundle section to your Shopify store

{% hint style="success" %}
**Steps:**

1. In the theme editor (**Customize**) > click **Add section**
2. Select **Products bundle.**
3. Make necessary changes.
4. **Save.**
   {% endhint %}

## How to edit a Products bundle section

### Section settings

#### General

* **Color scheme**: Choose a theme color preset. [Learn more →](https://docs.foxecom.com/hyper-theme/theme-settings/colors)

#### **Image**

* **Image:** Upload a main visual for the bundle.
* **Desktop image position:** Align the image to the *Left* or *Right* of the products list.
* **Image ratio:** Choose *Adapt to image* or *Full section height*.
* **Show hotspot:** Toggle ON to activate clickable product hotspots on the image.

  * On **desktop**, hovering over a hotspot highlights the corresponding product card, helping users quickly identify the item in the bundle.

  <figure><img src="https://3026705042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAJrvmfqcj9TMoPkl3bNc%2Fuploads%2FIoFujH8eW9KV43JyEPn7%2FUntitled%20design%20(45).gif?alt=media&#x26;token=c149f8c6-9b0d-4c0f-8fb4-90bfd1a4b36a" alt=""><figcaption></figcaption></figure>

  * On **mobile**, tapping a hotspot automatically scrolls to the relevant product card, ensuring smooth navigation in smaller viewports.

#### Section header

{% hint style="info" %}
The Section header display above the products list.
{% endhint %}

<details>

<summary>See settings</summary>

* **Subheading**: Add a short, secondary heading to complement the main heading. This can provide additional context or detail.
* **Heading**: Enter the primary title for your banner.
* **Heading size:** Adjust the size to fit your design preference and ensure readability. Choose from available heading sizes.

:writing\_hand: [add-highlighted-text-to-your-headings](https://docs.foxecom.com/hyper-theme/faqs/add-highlighted-text-to-your-headings "mention")

* **Text:** Add a detailed explanation or summary for the banner. Use rich text formatting like **bold**, *italic*, links, and lists for better visual emphasis.

</details>

#### **Grid settings**

* **Number of columns on desktop:** Set how many product cards appear in a row (2–4).
* **Column gap:** Adjust the horizontal spacing between cards.

<figure><img src="https://3026705042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAJrvmfqcj9TMoPkl3bNc%2Fuploads%2FRqviN6GgcK0MeJlaOV3O%2Fimage.png?alt=media&#x26;token=59b6d8f1-b041-4b61-86fc-bbf01a2ff297" alt=""><figcaption></figcaption></figure>

**Product cards**

* **Image ratio:** Choose a custom image ratio for the product cards in this section or use the global setting.

**Mobile layout**

* **Mobile image:** Upload an optimized version for mobile.
* **Number of columns on mobile:** Choose *1* or *2* product cards per row.

<figure><img src="https://3026705042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAJrvmfqcj9TMoPkl3bNc%2Fuploads%2FPr4N65MbiVL0dFw7sBZJ%2Fimage.png?alt=media&#x26;token=c15ea642-d718-42bf-93f8-53d9dd4a977e" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
The section show a **Add all to cart** button at the bottom of the bundled products list.&#x20;

![](https://3026705042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAJrvmfqcj9TMoPkl3bNc%2Fuploads%2FCbpoevO42eZ5bslsJdBI%2Fimage.png?alt=media\&token=84b1cc8c-c1f8-4cb5-b7b7-69bb2c6a0fbc)

:white\_check\_mark:  Customers can pick the variant (e.g., size, color) before adding everything to their cart.<br>

* To change this button label, go to **Actions > Edit default theme content**.

![](https://3026705042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAJrvmfqcj9TMoPkl3bNc%2Fuploads%2Fbsm1mrrxRbfQ8EwKuY5c%2Fimage.png?alt=media\&token=78248313-63e5-4e60-806d-a3a5288d5834)\
\
![](https://3026705042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAJrvmfqcj9TMoPkl3bNc%2Fuploads%2Ff149OPAoEqwmKuMev6wv%2Fimage.png?alt=media\&token=63e481eb-1496-4ed0-85ae-c6db81aeac30)
{% endhint %}

### Block settings

Each bundled product is added as a block.

#### **Product**

* **Product:** Select a Shopify product.

#### **Hotspot (only if enabled)**

* **Color scheme:** Set the color preset for the hotspot marker. The hotspot's background color inherits the **Background color 1** of the selected Color scheme.
* **Horizontal position / Vertical position:** Drag or manually set hotspot placement (desktop view).
* **Mobile settings:** Fine-tune hotspot position for mobile view separately.

## Best practices

✅ Use high-quality hero images with good contrast for hotspots.

✅ Bundle 3–5 products for best visual balance.

✅ Use consistent background colors between image and product cards.

## FAQs

### **Can customers buy individual items from the bundle?**&#x20;

👉 Yes. Each product is still clickable to access the product details page and purchase separately.

### **What happens if a product goes out of stock?**&#x20;

👉 The unavailable product will show "Sold out" but won't break the entire bundle layout. However, customers won't be able to add the bundled products as a whole. So make sure you keep track of the product inventory for timely updates!

<figure><img src="https://3026705042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAJrvmfqcj9TMoPkl3bNc%2Fuploads%2F6GXi2TOXAd3YAkZBs4IC%2Fimage.png?alt=media&#x26;token=b1987a65-703e-49bf-b12f-a33de51ed2ed" alt=""><figcaption></figcaption></figure>

***

<figure><img src="https://3026705042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAJrvmfqcj9TMoPkl3bNc%2Fuploads%2FkUIzEsJKOeRiz891zyf5%2Flivechat883x471%20(1).png?alt=media&#x26;token=90cbed2c-e791-49c8-9f43-49a08bed6f1f" alt=""><figcaption><p><a href="https://apps.shopify.com/xflow?utm_source=foxecom&#x26;utm_medium=help_center_hyper&#x26;utm_campaign=banner">Install XFlow Back In Stock Automation FREE</a></p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.foxecom.com/hyper-theme/theme-sections/products-bundle.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
