Pizza Builder and Tea Builder are two selection types that turn a list of options into a picture the customer builds on. Pizza Builder places toppings on a pizza, on the whole pie or on one half. Tea Builder places add-ons in a drink cup. Both are set up like any other modifier group, with a few extra settings.
The end result
A Build Your Own Pizza at $12.00 with a toppings group. The customer chooses Left Half, Full or Right Half, taps a topping, and sees it appear on that part of the pizza. And a Brown Sugar Milk Tea at $5.50 where tapping an add-on drops it into the cup.
Pizza Builder
Step 1 – Create the group
In the left sidebar click Shop+, stay on Products, click the Modifiers tab and click Create. Enter the Group Name (Pizza Toppings) and the External Name. Leave Minimum Selection empty so toppings are optional, set Maximum Selection to the most toppings you allow, and set Selection Type to Pizza Builder. Tick Available Online so the group shows on the online store.
Step 2 – Set the Pizza Builder Settings
Choosing Pizza Builder adds a settings block to the Configuration Settings card:
Shape: the outline of the pizza, for example Circle.
Pizza Base Style: the look of the base.
Topping Display Size: how large toppings are drawn, for example Medium.
Allow Half Toppings (Left/Right): turn on to let a topping go on one half.
Half Topping Price (%): the percentage of the full topping price used for a half. 50 means half price.
Step 3 – Add the toppings
In the Modifier Items card click + Add Item for each topping, type its name, press Enter and enter its price for a whole pizza. This example has Pepperoni 1.5, Italian Sausage 1.5, Mushrooms 1, Green Peppers 1 and Extra Cheese 2. Click Save Modifier.
Step 4 – Attach the group to the pizza
Open the pizza product, scroll to Product Modifiers, select Pizza Toppings in Select modifier groups and click Update Product.
Step 5 – See the result
On the product page the customer picks Left Half (50%), Full or Right Half (50%), then taps toppings under Available Toppings. Each topping is drawn on the pizza and tagged F for full, L for left or R for right, with an × to remove it. While a half is selected, the topping tiles show the half price. The counter at the top of the group shows how many toppings have been chosen out of the maximum.
Tea Builder
Step 1 – Create the group
Click Create on the Modifiers tab. Name the group (Boba Add-Ons), leave the minimum empty, set a maximum and set Selection Type to Tea Builder.
Step 2 – Set the Tea Builder Settings
Cup Style: the cup drawn, for example Bubble Tea Cup.
Tea Color: the color of the drink, for example Milk Tea.
Topping Display Size: how large add-ons are drawn.
Show Ice Cubes by Default: whether the cup starts with ice.
Step 3 – Add the add-ons and attach the group
Add each add-on as an item with its price, for example Tapioca Pearls 0.75, Lychee Jelly 0.75 and Cheese Foam 1. Click Save Modifier, then attach the group to the drink under Product Modifiers.
Step 4 – See the result
The customer taps add-ons under the cup and each one appears in the drink.
Tips
Use one toppings group for every build-your-own pizza size. If toppings cost more on a large, duplicate the group, change the prices and attach the copy to the large.
Keep required questions, such as crust or sweetness level, in their own Single Choice groups placed before the builder in the product's Display order.
To keep an option in the group but out of the picture, expand the option, click More settings and tick Hide from builder.
For specialty pizzas, create a product per pizza and attach the same toppings group for additions.
Common questions
How do I offer half-and-half pizza? Use a Pizza Builder group with Allow Half Toppings turned on.
How do I charge half price for a half topping? Set Half Topping Price (%) to 50.
How do I limit the number of toppings? Set Maximum Selection on the group.
Can I use the Pizza Builder for something other than pizza? It always draws a pizza. For other items use Multi Select.
Why does the builder not show on my online store? Check that Available Online is ticked on the group and that the product is published to the Online Store channel.




