Combo options

Some items aren’t a single fixed dish. A lunch special where the guest picks a protein, a side, and a drink; a poke bowl where they choose a base and up to three toppings. Combo options let one product carry several of those choices at once, instead of making you create a separate product for every possible combination.

When to use combo options instead of variants

A variant is a single choice on a product, one size, one temperature. Combo options are for a product that needs several independent choices at the same time.

The clearest case is a menú del día: one “Almuerzo ejecutivo” product, priced once, with a group for the protein (say ten choices), one for the side (two), one for the juice (two), one for the soup (two). Modeled as variants that’s eighty separate products to keep in sync; as combo options it’s one product and four short lists.

A product uses one path or the other. If a product has combo options, guests build the combo when they tap it and any variants on that same product aren’t shown.

The shape

Product            (Almuerzo ejecutivo — $22 000)
├── Option group   (Protein — pick 1, required)
│   ├── Choice     (Chicken        + $0)
│   ├── Choice     (Grilled fish   + $4 000)
│   └── Choice     (Chicharrón     + $2 000)
└── Option group   (Toppings — pick up to 3, optional)
    └── …

A group is one decision the guest makes. A choice is one option within that decision.

Setting it up

Combo options are edited on their own screen rather than inline on the product form, a combo can get large and needs the room. Save the product first, then use Manage combo options on the product’s edit screen. A brand-new product takes you there automatically right after its first save.

For each group:

Name, the heading the guest sees for that decision, “Protein,” “Choose your base.”
How many to pick, a minimum and a maximum. 1 to 1 is a straight single choice. 0 to 3 is “up to three, or none.” 2 to 2 is “exactly two.” Keep the minimum at or below the maximum, a group asking for more than it allows can never be completed.
Required, whether the guest must make this choice before adding the item. A minimum of one or more already forces it; this is the explicit switch.
Free choices, how many picks in this group are included in the base price before extras start adding on. See Pricing.

For each choice inside a group:

Name, “Chicken,” “Grilled fish.”
Price adjustment, added to the product’s base price when the guest picks it. Can be zero, or negative.
Description and image, optional, the same as a product’s.

Add each new group at the bottom of the list, and each new choice at the bottom of its group.

Pricing

A combo’s price is the product’s base price plus the price adjustment of every choice the guest picked. Nothing else changes, tax and the tab total behave exactly as they do for any other item.

Free choices cover the common “three toppings included, extras $1 each” case. Set the group’s free-choices count to 3, give each topping a $1 price adjustment, and the guest’s three cheapest picks in that group come through at no charge, only the fourth topping onward adds its $1. A guest always pays for their most expensive extras, never their first-added ones.

Keep the two uses separate: a group with free choices should hold only priced add-ons (adjustment of 0 or more). Put anything that lowers the price — a smaller size, a “no protein” option — in its own group with free choices set to 0, so that discount always applies instead of being absorbed by a free slot.

Reordering

Groups appear to guests in the order you set them, and choices in the order within each group. Both are rearranged by dragging: the combo options screen has a reorder toggle that switches to a compact, drag-friendly view.

A combo product shows its groups underneath the name so you can read the shape at a glance, “Protein: Chicken, Grilled fish” while a group is short, “Toppings (6)” once a group has more than two choices.

From the guest side

Tapping a combo product opens a screen with each group as its own short list, required groups marked, the running total updating with every pick. The guest can’t add the item until every required group is satisfied. See Placing an order.