Theme Customization

Theme Extension Settings

The theme extension has a number of settings that allow you to control how the extension functions and displays.


Extension Settings

Product

The product setting is used to select the displayed bundled product. You have a few choices here depending on where you have placed the Bundle Selection component.

Product from current page

If a product is currently available within the context of the current page then it will autofill the selection. Use this option when you are adding the selector to a product template. Image

Manual selection

The manual selection allows you to select a static product. This is useful if you have placed the product selection component on a non-product page.

Enable Custom Form Handling

This setting will enable the out-of-the-box form-handling solution for your bundle products. We recommend using this if you do not intend to roll your own solution, want to quick-start, or are just testing. When enabled, it will add a quantity selector, a total price component, and an add-to-cart button.

Remove conflicting components

You should also remove the price, variant picker, quantity selector, and buy button blocks from the template to avoid conflicting with the custom form.

Use cart attributes

When enabled, the customers' bundle selections will be shown in the cart as line item properties. Use this if your theme does not support line item components. If your theme utilises line item components, then the bundle products will be automatically displayed, and this setting will not be needed.

Show Product SKUs

This setting will display the SKU (stock-keeping unit) next to each product option in the bundle for easy identification.

Show quantity selector

This setting only applies when custom form handling is enabled and will show a quantity selector when adding the bundle to the cart. The setting is enabled by default.

Metadata only

When enabled the bundle data will be loaded into the current page without the bundle selection UI. You can use this to build your own bundle selection component. See Javascript API for more information.

Previous
Launching Your Bundle