Overview

Show or hide options based on the customer’s previous selections, including the Shopify variant they’ve chosen.

Conditional logic turns a long form into a shorter, more relevant experience. Instead of showing every option to every customer, display each option only when it applies to their selections.

For example:

• Show a gift message field only when the customer selects gift wrapping.

• Show shoe width options only for sizes that are available in different widths.

• Show engraving font options only after the customer enters an engraving message.

Watch it done — 1:55. Rules that reveal an option only when it is relevant, so a long form stays short for the customer in front of it.

What it can do

Capability	Detail
Show or hide any option	All 32 option types support conditional logic, including the static ones.
Show or hide a whole group	A rule on a Section applies to everything inside it.
React to another option	Any earlier option in the same option set can be the trigger.
React to the Shopify variant	Show an option only for a specific variant the customer selected. See Conditions based on Shopify variants.
Combine several conditions	With All or Any matching.
Count rather than compare	Number of characters typed, number of values selected, number of files attached.

What it cannot do

• It cannot change an option’s price, label, or values. Conditional logic only controls whether an option is shown or hidden.

• It cannot read customer information, country, or cart contents. These are controlled by option-set-level rules - see Assign to customers and Assign to countries.

• It cannot use an option that appears later in the form as a condition. Conditions can only reference options that appear earlier in the form.

• It cannot use every option type as a trigger. Twelve option types cannot be used as conditions - see Build a condition.

The rule in one sentence

Every rule is presented as a single sentence in the app:

Show this field if All of the following match: Gift wrap — contains — Yes, wrap it as a gift

Each rule has four parts: an action, a matching mode, and one or more conditions. Each condition consists of a source, an operator, and a value.

Every rule is an action, a matching mode, and a list of conditions.

Pages in this section

Turn on conditional logic

Where the switch is, and the Show / Hide and All / Any choices.

Build a condition

Choosing a source, an operator, and a value — and what can be a trigger.

Operators reference

Every operator, grouped by the type of the source option.

Conditions based on Shopify variants

React to the variant the customer picked, and what to check if it does not work.

Examples and recipes

Eight complete rules you can copy.

Troubleshooting

When a rule fires at the wrong time, or never.

Two things to know before you start

Hidden options are not validated. If a required option is hidden by a rule, it will not prevent the customer from clicking Add to cart. This is intentional—otherwise, a hidden required field could make the product impossible to purchase. However, it also means that an option is only required while it is visible. Be sure to test both branches of every rule.

Conditions can only reference options that appear above the option you are configuring. The source dropdown only lists options that appear earlier in the form. If the option you want to use as a condition is not listed, move it above the current option in the builder. See Build your options.

Plans

Conditional logic works at two levels, depending on your plan:

Level	What you get
Basic	Rules based on other options in the option set.
Advanced	The same, plus conditions based on the Shopify variant the customer selected.

On a Basic plan, you can still select Shopify variant as a source, but the operator and value fields are locked with an upgrade prompt. See Compare plans.

Where to put the rule

If several options should appear or disappear together, apply a single rule to the Section that contains them instead of adding the same rule to each option. This is faster to set up, easier to maintain, and helps keep the logic consistent.