Skip to main content

Theme Settings Reference

All Collection Bundle block settings available in the Shopify Theme Customizer. For global styling, see [Customization](11-customization.md).

Updated yesterday

Quick Reference

Category

Setting

Default

Purpose

Config

Bundle Product

Select which bundle to display (required for page/collection templates)

Layout

Column Count

2

Desktop grid columns (1-4)

Mobile Column Count

1

Mobile grid columns (1-2)

Display

Show Bundle Title

On

Title visibility

Show Bundle Price

On

Price visibility

Show Custom Add to Cart Button

On

Custom button vs native form

Modal

Show Product Prices in Modal

On

Individual prices in popup

Show Step Titles in Modal

Off

Step context in popup

Hide Out of Stock Products

Off

Hide unavailable items

Quick Select Single Variant Products

Off

Skip detail popup for single-variant

Cart

Show Bundle Items Text in Cart

On

Summary on cart line item

After Adding to Cart

Open Cart Drawer

Post-add behavior

Custom Cart Events

(blank)

Theme cart integration events

Colors

Background

#ffffff

Container background

Text

#000000

Main text color

Border

#e5e5e5

Card/divider borders

Button

#000000

ATC button background

Button Text

#ffffff

ATC button text

Price

#000000

Regular prices

Compare At Price

#767676

Crossed-out prices

Sale Price

#c33a0f

Discounted prices

Swatches

Theme Swatch Setting

(blank)

Path to theme swatch definitions

Custom Swatches

(blank)

Custom color mappings

Advanced

Use Form Wrapper for Button

On

Wrap ATC in form element


Custom Cart Events

If your theme's cart drawer doesn't open after adding a bundle, add the correct event to Custom Cart Events.

Format: Comma-separated event names, e.g., theme:cart:update,cart-drawer:open

Theme

Event(s)

Dawn / Shopify OS 2.0

cart:refresh

Impulse

theme:cart:update

Prestige

cart:refresh

Custom themes

Check theme docs or search JS for dispatchEvent


Troubleshooting

  • Bundle not displaying — Block added? Template assigned? Bundle product configured (for page/collection templates)? Product published?

  • Cart drawer not opening — Add your theme's cart event to Custom Cart Events

  • Colors not applying — Clear cache; check for conflicting theme CSS; verify hex codes include #

  • Swatches not showing — Products need a "Color"/"Colour"/"Finish" option; check Theme Swatch Setting path

  • Products not in modal — Verify collection has published products; check if Hide Out of Stock is enabled


Related Articles

Did this answer your question?