Conditional Logic
Conditional logic lets you show or hide any element based on what the customer has already selected. Use it to build dynamic, responsive option sets that only ask customers for what’s relevant to their choices.
Overview
Every element has a Conditions tab in its settings panel. You can add one or more conditions there. When conditions are present, the element is hidden by default and only shown when the conditions are met (or vice versa, depending on the rule).
How conditions work
A condition is a rule that checks the current value of another element in the same Option Set. If the rule is satisfied, the action fires.
Example: Show a “Gift message” Text Area only when the customer has selected “Yes” on a “Include gift card?” Switch.
IF "Include gift card?" is ON
THEN show "Gift message"Condition actions
| Action | Behavior |
|---|---|
| Show when | The element is hidden until the condition is true |
| Hide when | The element is visible until the condition is true, then hides |
The most common pattern is Show when — elements start hidden and appear when a relevant choice is made.
Combining conditions
Within one element’s conditions, you can add multiple rules and combine them:
| Combinator | Meaning |
|---|---|
| AND | All rules must be true simultaneously |
| OR | Any one rule being true is sufficient |
You can mix AND and OR by grouping conditions in the UI.
What happens to hidden elements
- Hidden elements are not validated — a required element that’s hidden will not block the add-to-cart
- Hidden elements don’t appear on the customer’s order — their answer is left blank
- When an element becomes hidden after the customer has entered a value, that value is cleared
Limitations
- Conditions only reference elements within the same Option Set — you cannot condition on elements from a different set on the same product
- Conditions cannot reference the product itself (e.g., product price or SKU)
- Loops — for example, if Field A shows only when Field B is visible, and Field B shows only when Field A is visible — are not detected by the app. Avoid this kind of setup, as it produces unpredictable results.
Continue to Conditions & Operators for the full list of supported operators per element type, or Examples for common use-case walkthroughs.