Bundles

Overview

A product bundle block that lists bundle items from a metafield and allows adding all selected variants to cart at once. Displays bundle products using the c__bundle-item snippet and integrates with the theme's cart functionality to add multiple line items simultaneously.

Common use cases

• Configure product bundles using the custom.product_bundle metafield (list of products)

• Use gap size settings to control spacing between bundle items based on your design needs

• Configure button colors to match your theme's design system

• Set appropriate padding based on the container context where the bundle block is displayed

• Test bundle functionality with products that have variants to ensure proper selection flow

Block settings

General

Setting	Description	Options
Show advanced settings	Reveals visibility settings	Checkbox (default: false)

Content

Setting	Description	Options
Product	Select the product to display bundle for	Product picker

Spacing

Setting	Description	Options
Enable horizontal padding	Adds horizontal padding around the bundle	Checkbox (default: false)
Enable top padding	Adds top padding around the bundle	Checkbox (default: false)
Enable bottom padding	Adds bottom padding around the bundle	Checkbox (default: false)
Gap size	Controls spacing between bundle items	• None • Default (default) • XS • SM • MD • LG • XL

Color

Setting	Description	Options
Disabled button color	Color scheme for the disabled "Choose Options" button	• Primary • Secondary • Tertiary • Neutral • Plain (default) • Outline • Inverted outline • Blur • Link • Inverted link
Main button color	Color scheme for the active "Add to Cart" button	• Primary (default) • Secondary • Tertiary • Neutral • Plain • Outline • Inverted outline • Blur • Link • Inverted link

Display

Setting	Description	Options
Visibility	Controls when the block is visible	• All (default) • Mobile only • Desktop only Visible when Show advanced settings is on