> For the complete documentation index, see [llms.txt](https://support.storefront.co.za/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.storefront.co.za/features/catalogue/products/bundle-products.md).

# Bundle Products

Bundles let you group two or more existing products together and sell them as a single, purchasable product on your storefront.

### How to Create a Bundle Product

A **Bundle** product lets you combine products you've already created into a single sellable item — for example, a "Weekend Getaway Bundle" made up of a tee and a headset. This guide walks you through every section of the Bundle product creation form.

#### Getting Started

1. From the back office, navigate to **Catalogue → Products** in the left-hand sidebar.
2. Click the **+ (Create)** button in the top-right corner of the Products page.
3. On the Create Product screen, click the **Create** button under **Bundles**. You will be taken to the Bundle product creation form, which is divided into the following sections accessible via the left-hand navigation panel.

#### Stores

Select which store(s) the bundle will be available on. By default, the product is not published to any store.

* Use the **Add Store** dropdown to select a store, then click **Add**.
* A product must be added to at least one store to be available for sale.

#### Basics

This section contains the core product information displayed to customers.

| Field              | Required | Description                                                                                    |
| ------------------ | -------- | ---------------------------------------------------------------------------------------------- |
| Full Name          | Yes      | The complete product name shown across the storefront and in search results.                   |
| Short Name         | No       | A condensed version of the name used in space-limited areas like receipts or mobile views.     |
| Product Code / SKU | Yes      | A unique identifier used to track the bundle internally for reporting and order management.    |
| Barcode            | No       | An optional code for physical handling or POS systems.                                         |
| Categories         | No       | Assign the bundle to one or more hierarchical categories to help customers navigate the store. |
| Tags               | No       | Keywords to improve search relevance and enable grouping for campaigns or filters.             |
| Short Description  | No       | A brief summary (max 250 characters) shown on listing pages or product previews.               |
| Full Description   | No       | A detailed overview including features and benefits. Supports rich text formatting.            |

**Tip:** The platform includes an **AI-Powered Auto-Fill** feature. Click the AI buttons next to any field to automatically generate professional product content.

#### Bundle Items

This is where you build the contents of the bundle.

1. Click **Add Item** to create a new position (slot) in the bundle — e.g. "Apparel" or "Electronics".
2. Give the item a descriptive **Label** so merchants and customers can tell each slot apart.
3. Tick **Required** if the customer must receive this item as part of the bundle (leave unticked if it's an optional add-on).
4. Click **Edit** on the item, then click **Add** in the Products panel to open the product picker.
5. Search for and tick the checkbox next to each product you want available in that slot, then click **Add** to confirm.
   * If you select more than one product for a single item, those products become **alternatives** — the customer will be able to choose between them when buying the bundle.
   * Set the **Default Qty** for each product, and tick **User Defined Qty** if customers should be able to change the quantity themselves.
6. Click **Back To Product** to return to the bundle overview and repeat the process to add further items (positions).

**Note:** Each item is a distinct slot in the bundle. If you want the bundle to include two separate, unrelated products (for example a T-shirt *and* a headset), create two separate items — one for each — rather than adding both products to the same item.

#### Pricing Behaviour

Set how the bundle is priced.

| Option  | Description                                                                                              |
| ------- | -------------------------------------------------------------------------------------------------------- |
| Dynamic | The bundle's price is calculated automatically as the sum of all selected items in the bundle.           |
| Fixed   | Enter a specific price you want to charge for the bundle, regardless of the combined value of its items. |

#### Images

Upload one or more images to show customers what the bundle looks like.

* Drag and drop image files onto the upload area, or click to browse your computer.
* Use square aspect ratio images to prevent cropping.
* Drag images left or right to reorder them. The first image is always used as the cover image.

#### Related Products

Add related products that will display at the bottom of the bundle's page on the storefront.

* Use **Add Related Products** to search by SKU or name.

#### Attributes

Add custom properties to the bundle (e.g. theme, occasion). Attributes are useful for storefront filtering and detailed specifications.

* Select an Attribute Set from the dropdown and click **Add** to apply a group of attributes.

#### SEO

Optimise how the bundle appears in search engine results.

| Field            | Description                                                                             |
| ---------------- | --------------------------------------------------------------------------------------- |
| Page Title       | The title shown in browser tabs and search results. AI generation is available.         |
| Keywords         | Comma-separated keywords relevant to the bundle.                                        |
| Page Description | A short summary for search engines (under 150 characters recommended).                  |
| Canonical URL    | The preferred URL for this bundle's page. Auto-generated from the product name on save. |

#### Sitemap URLs

Add additional URLs for the bundle if needed. A default URL is automatically generated when the bundle is saved, so this section typically does not need to be edited.

#### Display & Behaviour

Control how the bundle is presented on the storefront.

| Field                | Description                                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Badges               | Add visual labels to the product card such as "New" or "Sale".                                                     |
| Display Order Weight | A numeric value that controls the bundle's sort priority within listings. Higher values appear first.              |
| Publish Date         | Schedule a date and time for the bundle to automatically appear on (and optionally disappear from) the storefront. |
| Sold Out             | Manually mark the bundle as sold out.                                                                              |
| Products Bought      | Show a social proof counter when a threshold number of units has been sold.                                        |
| Disable Reviews      | Hide the ratings and reviews section for this bundle.                                                              |

#### Order

Set purchase quantity limits for the bundle.

| Field                | Description                                                                    |
| -------------------- | ------------------------------------------------------------------------------ |
| Minimum              | The minimum number of units a customer must buy per order.                     |
| Maximum              | The maximum number of units a customer can add to a single order.              |
| Maximum Per Customer | Limits the total units a single customer can purchase across all their orders. |
| Enquiry              | When enabled, replaces the buy button with an enquiry or contact form.         |

#### Documents

Upload supporting files that customers can download from the bundle's detail page (PDF or DOC format).

#### Metadata

Add custom backend key-value pairs to the bundle. These are not visible to customers but can be used for integrations or custom logic rules.

* Enter a **Key** and **Value**, then click **Add**.

#### Saving the Bundle

Once you have completed all relevant sections, click the **Save** button in the bottom-right corner of the page. The bundle will be created and saved to your catalogue. If you added it to a store, it will become visible on the storefront according to any publish date you have set.