> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.ushopaid.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Configure Product Lists in the Mix & Match Bundle Editor

Product Lists control which products customers can choose from when building a Mix & Match Bundle.
In the **Mix & Match Bundle Editor**, you can configure Product Lists to control:
* Which products are available
* Where products come from
* How many products customers can select
* How many units of the same product can be added
* How variants are displayed
* How customers filter products
* How the product list appears on desktop and mobile
|| This guide applies to the **Mix & Match Bundle Editor** version. The available settings may be different in the Legacy version.

# Open ProductList settings
After entering the Bundle Editor, go to:
**Products & Layout → ProductList**
Select the ProductList you want to configure.
A ProductList contains the products that customers can choose from when creating their bundle.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/f/1/4df10d1472327800/image_15w88qg.png)

*Open ProductList settings from Products & Layout.*

# Step 1: Choose your product source
Under the **Products** section, choose where products come from.
Available options include:
* Specific products
* Specific collections

## Specific products
Use this option when you want to manually select products for the ProductList.
Recommended for:
* Curated bundles
* Small product selections
* Hand-picked product combinations
Example:
```
Bracelet A

Bracelet B

Bracelet C
```

## Specific collections
Use this option when you want products to come from a Shopify collection.
Recommended for:
* Larger product catalogs
* Product groups managed in Shopify collections
Example:
```
Collection:

Long Sleeve Shirts
```

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/f/1/4df10d1472327800/image_ob02r8.png)

*Choose whether your ProductList uses specific products or a Shopify collection.*

# Step 2: Configure quantity settings
Quantity settings control how customers can select products from a ProductList.

## Items from this list
Controls how many products customers can select from this ProductList.
Use this setting to create rules such as:
* Choose at least 3 products
* Choose up to 5 products
Example:
```
Minimum quantity: 3
```
Customers must select at least 3 products before completing the bundle.

## Items per product
Controls how many units of the same product customers can add.
This setting includes:

### Initial add quantity
Controls the quantity added when customers click **Add** for the first time.
Example:
```
1
```
First click:
```
Added quantity: 1
```

### Increment quantity
Controls how much the quantity increases when customers click the **+** button.
Example:
```
1
```
Each click increases the quantity by 1.

### Maximum quantity limit
Limits the maximum number of units for the same product.
Example:
```
Maximum quantity: 2
```
Customers cannot add more than 2 units of the same product.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/f/1/4df10d1472327800/image_11wjatb.png)

*Configure how many products customers can select and how many units of each product are allowed.*

# Step 3: Configure product variant display
Under **Advanced settings**, you can control how product variants appear in the ProductList.

## Display variants as individual products
Enable this option when you want each product variant to appear as a separate product choice.
Example:
Shopify product:
```
T-shirt
```
Variants:
```
Red / Small

Blue / Medium

Black / Large
```
When enabled, customers see:
```
T-shirt Red Small

T-shirt Blue Medium

T-shirt Black Large
```
Use this when each variant should be treated as an independent product selection.

When disabled, customers see the main product and can select variants through the product card experience.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/f/1/4df10d1472327800/image_jqny3r.png)

*Choose whether variants should appear as separate products.*

# Step 4: Enable product filtering
Product filtering helps customers browse products more easily when a ProductList contains many products.
Product filtering uses filters configured in Shopify **Search & Discovery**.

## Requirements
Product filtering works when:
* ProductList source type is **Specific collections**
* Only **one collection** is selected
* Filters are configured in Shopify Search & Discovery
It does not support:
* Multiple collections
* Manually selected products

## Configure filters in Shopify Search & Discovery
Create filters such as:
* Price
* Category
* Material
* Size
* Other Shopify filters

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/f/1/4df10d1472327800/image_1078czz.png)

*Configure available filters in Shopify Search & Discovery.*

## Enable filtering in uShopAid
Go to:
**ProductList → Advanced**
Enable:
**Enable filtering**
You can also customize:
**Filter button text**
Example:
```
Filter
```

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/f/1/4df10d1472327800/image_dj8qmc.png)

*Enable filtering from ProductList Advanced settings.*

## Customer experience
When filtering is enabled, customers can click the **Filter** button above the ProductList.
A filter drawer will open, allowing customers to:
* Select filter options
* Apply filters
* Clear selected filters

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/f/1/4df10d1472327800/image_luzszn.png)

*Customers can filter products while building their bundle.*

# Step 5: Configure Display name
Display name controls the name shown to customers in the bundle summary panel.
It is mainly useful when your bundle contains:
* Multiple Product Lists
* Multiple steps
Example:
Default:
```
Step 1
```
Custom:
```
Choose your shirts
```
or:
```
Select your accessories
```
This helps customers understand what they are currently selecting.
|| Display name is most useful for multi-step bundles or bundles with multiple Product Lists. It has limited value when there is only one ProductList.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/f/1/4df10d1472327800/image_uclsem.png)

*Customize the step name shown in the bundle summary panel.*

# Step 6: Customize ProductList layout
Open the **Styling** tab to adjust how products are displayed.
You can customize:
* Items per row
* Horizontal gap
* Vertical gap
* Typography
* Size
* Spacing
* Background
* Border
* Effects

## Items per row
Controls how many products appear in each row.
You can configure different layouts for:
* Desktop
* Mobile
Examples:
Desktop:
```
Product A | Product B | Product C
```
Mobile:
```
Product A | Product B
```

## Horizontal gap
Controls the spacing between products in the same row.
Example:
```
16px
```

## Vertical gap
Controls the spacing between product rows.
Example:
```
8px
```

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/f/1/4df10d1472327800/image_71rkg8.png)

*Adjust ProductList layout, spacing, and responsive display settings.*

# ProductList vs ProductCard
ProductList and ProductCard control different parts of the bundle experience.
|| ProductList controls which products customers can choose from and how the list behaves.
|| ProductCard controls how each individual product appears inside the list.

## ProductList controls:
* Product source
* Collection selection
* Quantity rules
* Product filtering
* Variant display
* Layout

## ProductCard controls:
* Product image
* Product title
* Price
* Variant picker
* Product badge
* Product rating
* Metafields
* Additional actions
Learn more:
[How to Customize Product Cards in the Mix & Match Bundle Editor](https://support.ushopaid.com/en/article/how-to-customize-product-cards-in-the-mix-match-bundle-editor-112rd2p/)

# Frequently asked questions
## Can I add products from collections?
Yes.
Choose **Specific collections** as your ProductList source.

## Can I manually select products?
Yes.
Use **Specific products** and select the products you want customers to choose from.

## Can customers add unlimited quantities of the same product?
You can control this using:
**Items per product → Maximum quantity limit**

## Why are my variants showing as separate products?
Check:
**ProductList → Advanced → Display variants as individual products**
If enabled, each variant will appear as an individual product choice.

## Can customers filter products in the bundle?
Yes, if:
* The ProductList uses one Shopify collection
* Filters are configured in Shopify Search & Discovery
* Enable filtering is turned on

## Why is the Filter button not showing?
Check:
* ProductList source type
* Number of selected collections
* Shopify Search & Discovery filter settings

## Why should I use Display name?
Display name is useful when your bundle has multiple Product Lists or multiple steps.
It helps customers understand what they are selecting.

## Can I customize how many products appear per row?
Yes.
Use:
**ProductList → Styling → Layout → Items per row**
You can configure different layouts for desktop and mobile.

# Related guides
[How to Create Your First Mix & Match Bundle](https://support.ushopaid.com/en/article/how-to-create-your-first-mix-match-bundle-18oy20o/)
[How to Customize Product Cards in the Mix & Match Bundle Editor](https://support.ushopaid.com/en/article/how-to-customize-product-cards-in-the-mix-match-bundle-editor-112rd2p/)
[How to Display Color, Size, and Other Variant Options in the Mix & Match Bundle Editor](https://support.ushopaid.com/en/article/how-to-display-color-size-and-other-variant-options-in-the-mix-match-bundle-r25xuk/)
[Understanding Discount Rules in the Mix & Match Bundle Editor]()