Home/Documentation/Modifier Sets
MENU & CUSTOMIZATION

Modifier Sets, Selection Rules & Option Behaviors

Create flexible modifier groups (Sizes, Milks, Sweetness, Toppings), configure required vs. optional rules, and choose how inventory and pricing are managed.

Interactive Customizer Simulator & Live Bundle Output

Interactive Simulator

Select options below to observe how the system calculates totals in real time and bundles lines for checkout:

1. Cup Size * Required (BASE_VARIANT)
2. Milk Choice • Single-select
3. Add-on Toppings (Multi-select)
4. Sweetness Level: 50%
CART TRANSFORM BUNDLE RESULT
1x Roasted Oolong Milk Tea
• Size: Size M
• Milk: Oat Milk (+$0.80)
• Sweetness: 50% Sweetness
• Toppings: Golden Boba (+$0.75)
Bundle Total:$6.80

3 Supported Option Behaviors

OPTIONStandard

Simple Option Surcharge

Directly adds an amount to the parent line (e.g. Extra sauce +$0.50, Light Ice +$0.00). No Shopify variant needed behind the option.

BASE_VARIANTBest for Sizes

Native Variant Mapping

Maps each choice directly to a real Shopify Product Variant (Sizes S/M/L) for accurate inventory depletion and sales reporting by SKU.

COMMERCE_COMPONENTChild Inventory

Nested Component Line

Each modifier is backed by an independent Shopify inventory item. Automatically deducts raw ingredient or retail stock upon order placement.

Branch-Level Sold Out Overrides

When Branch A runs out of Oat Milk or Boba Pearls while Branch B still has stock:

Go to Settings > Locations > Menu Overrides, pick the location, and toggle Sold Out for that modifier. The option is immediately disabled on that location's Shopify POS terminals and dine-in QR menus without affecting other stores.