Rule Conditions

Rule Conditions

Overview

Conditions are the "if" part of every visibility rule and value rule. Each condition checks the current value of an option or variable and compares it using an operator. When the conditions on a rule are satisfied (based on the All/Any/None logic), the rule's action fires. You add conditions inside any rule on the Visibility Rules or Value Rules tab of an option by clicking Add condition.

Quick Reference

Logic Modes

A single rule can have multiple conditions. The logic mode at the top of the rule controls how they combine:

  • All — Every condition must be true for the rule to fire.
  • Any — At least one condition must be true.
  • None — The rule fires only when no condition is true (useful for "if NOT" logic).

Building a Condition

  1. Select a source — pick the option you want to check (listed by key), or a pricing variable from the Variables section.
  2. For a Dimensions option only — choose Dimension (which axis to test: Length, Width, and so on). Each axis uses the same numeric operators as a number field. The saved field is dimensionProp (dim1 for the first row, dim2 for the second, in row order).
  3. Choose an operator — the available operators depend on the source type (see table below). For Dimensions, pick a dimension first; operators then match Number / Slider / Quantity / Measurement.
  4. Enter a comparison value — type or select the value to compare against. For choice-type sources, you pick from the available choice values.
  5. Or compare with a formula (numeric sources) — on a Number, Slider, Quantity, Measurement, Dimensions-axis or pricing-variable source, click the fx button beside the value box. The number box is replaced by a formula editor under the condition, and the condition compares the source against the formula's result each time the shopper changes something. Use INPUT("KEY") for a number the shopper enters, INPUT("KEY", "dim1") for one axis of a Dimensions option and VAR("KEY") for a pricing variable — for example Quantity greater than INPUT("WIDTH") * 2. Click fx again to go back to a fixed number. Rules that Chat with AI writes this way show and edit here like any other condition.

Operator Reference

Source Type Available Operators
Text / Email Equals, Not equals, Contains, Does not contain, Starts with, Ends with, Is empty, Is not empty
Number / Slider / Quantity / Measurement Equals, Not equals, Greater than, Greater than or equal, Less than, Less than or equal, Is empty, Is not empty
Switch Equals (True / False)
Dropdown / Radio / Button Equals, Not equals, Is empty, Is not empty
Checkbox / Color Swatch / Image Swatch Contains, Does not contain, Is empty, Is not empty
Date Equals, Not equals, Before, After, Is empty, Is not empty
Time Equals, Not equals, Before, After, Is empty, Is not empty
Color Picker Equals, Not equals, Is empty, Is not empty
Font Picker Equals, Not equals, Is empty, Is not empty
Dimensions (after you pick a dimension row) Equals, Not equals, Greater than, Greater than or equal, Less than, Less than or equal, Is empty, Is not empty — applied to that single axis value only
File Upload Equals, Not equals, Is empty, Is not empty
Pricing variables Equals, Not equals, Greater than, Greater than or equal, Less than, Less than or equal, Is empty, Is not empty

Details

  • Use the option key (not the label) when referencing options in formulas or mentally mapping conditions. The key is visible on the Basic Settings tab of each option.
  • Dimensions options store one object in cart/state; rule conditions never compare the whole object at once. Always pick Dimension (dim1, dim2, …) so the condition compares one numeric cell. Is empty / Is not empty refer to that cell only (blank vs entered).
  • "Is empty" and "Is not empty" are useful for rules that should fire when a customer has or hasn't interacted with a field.
  • You can mix different source types in the same rule. For example, one condition checks a Dropdown value while another checks whether a pricing variable such as AREA is greater than 100.
  • Pricing variables use the current calculated value (the same number as VAR("KEY") in formulas). They are numeric, so you compare them with number operators.

Examples

  • Show engraving options only for wood material — Condition: option MATERIAL equals "Wood." Logic: All. Action on the target option: Show.
  • Require phone number when express shipping is selected — Condition (logic: All): option SHIPPING equals "Express." Action: Require on the PHONE option. The phone number becomes required only for express orders.
  • Show a large-format note when calculated area is over 100 — Condition: variable AREA is greater than 100. Logic: All. Action on the target option: Show if.