Operators reference

Every conditional logic operator, grouped by the type of the source option, with what each one matches.

The operators available depend on the type of the source option. There are seven sets of operators, listed on this page.

Quick index

If your source is…	Jump to
Text, Textarea, Email, Phone, Color picker, or Shopify variant	Text sources — 10 operators
Number or Range slider	Numeric sources — 4 operators
Date and time picker	Date sources — 2 operators
File upload	File upload sources — 6 operators
Radio button or Font picker	Single-choice sources — 2 operators
Select, Dropdown, Color dropdown, Image dropdown, Checkbox, Button, Color swatch, Image swatch	Multi-choice sources — 8 operators
Switch	Switch sources — 2 operators

Text sources

Applies to: Text, Textarea, Email, Phone, Color picker, and Shopify variant.

Operator	Value field	Matches when the entry…
is equal to	Text	is exactly your value, character for character
is not equal to	Text	is anything other than your value
starts with	Text	begins with your value
ends with	Text	finishes with your value
contains	Text	has your value somewhere inside it
does not contain	Text	does not have your value anywhere inside it
number of characters is equal to	Number	is exactly that many characters long
number of characters is not equal to	Number	is any other length
number of characters is greater than	Number	is longer than that
number of characters is less than	Number	is shorter than that

Worked examples

Condition	Fires when the customer
Engraving text — number of characters is greater than — 0	has typed anything at all. The standard way to say "they want engraving"
Engraving text — number of characters is greater than — 12	has typed a long message — use it to reveal a "this may not fit" warning
Email — contains — @ourcompany.com	is a colleague, for internal-only options

Use number of characters is greater than 0 to detect that the customer has entered something, without checking the value itself.

Numeric sources

Applies to: Number, Range slider.

Operator	Value field	Matches when the number…
is equal to	Number	is exactly that
is not equal to	Number	is anything else
is greater than	Number	is above that
is less than	Number	is below that

Worked examples

Condition	Use for
Quantity of names — is greater than — 4	Revealing a bulk-order note or a longer lead time
Width — is greater than — 180	Revealing an oversized-delivery surcharge option
Number of guests — is less than — 4	Hiding a group discount option

There is no "greater than or equal to" operator. To match 4 or more, use is greater than 3.

Date sources

Applies to: Date and time picker.

Operator	Value field	Matches when the date…
is equal to	Text	is exactly that date
is not equal to	Text	is any other date

Only two operators are available, so date conditions match specific dates rather than ranges. Enter the value in the same format the option is configured to use. See Date and time picker.

To control which dates the customer can select, use the option's Limit date picker settings instead of conditional logic.

File upload sources

Applies to: File upload.

Operator	Value field	Matches when
has file	None	at least one file is attached
no file	None	nothing is attached
number of files is equal to	Number	exactly that many are attached
number of files is not equal to	Number	any other number are attached
number of files is greater than	Number	more than that are attached
number of files is less than	Number	fewer than that are attached

has file and no file do not take a value. The operator is the complete condition.

Worked examples

Condition	Use for
Your photo — has file	Revealing cropping instructions or a placement choice once they have uploaded
Your photo — no file	Showing a "we can design one for you" paid option
Photos — number of files is greater than — 4	Revealing a collage layout choice

Single-choice sources

Applies to: Radio button, Font picker.

Operator	Value field	Matches when
is equal to	Dropdown of that option's values	that value is selected
is not equal to	Dropdown of that option's values	anything else is selected

Only one value can be selected on these types, so count and containment operators do not apply.

The value is selected from a dropdown listing the source option's own values, so there is no risk of a typing error.

Multi-choice sources

Applies to: Select, Dropdown, Color dropdown, Image dropdown, Checkbox, Button, Color swatch, Image swatch.

Operator	Value field	Matches when
is equal to	Dropdown of values	that value is the selection
is not equal to	Dropdown of values	the selection is something else
contains	Dropdown of values	that value is among the selections
does not contain	Dropdown of values	that value is not among the selections
number of selections is equal to	Number	exactly that many are selected
number of selections is not equal to	Number	any other number are selected
number of selections is greater than	Number	more than that are selected
number of selections is less than	Number	fewer than that are selected

is equal to versus contains

This is the most important distinction on this page.

Operator	Behavior	Use when
is equal to	Matches only when that value is the selection	The option is single-select, or you specifically mean "only this one"
contains	Matches when that value is among the selections	The option allows multiple, and you mean "they picked this, possibly with others"

On a Checkbox, or any option with Allow multiple enabled, use contains instead of is equal to. If a customer selects Gift wrap and Gift bag, the selection is not equal to Gift wrap, so an is equal to rule does not match. This is the most common mistake when building conditions.

Worked examples

Condition	Use for
Gift wrap — contains — Yes, wrap it as a gift	Revealing a gift message box
Extras — number of selections is greater than — 2	Revealing a bulk note, or a longer lead time warning
Size — is equal to — XL	Revealing an option only for one size
Finish — does not contain — Standard	Revealing a premium-finish care note

Switch sources

Applies to: Switch.

Operator	Value field	Matches when
is enabled	None	the switch is on
is disabled	None	the switch is off

Neither operator takes a value. A Switch has two states and no typed value, which makes it a reliable trigger.

If you need a complex rule on a text field to detect whether the customer wants an option, add a Switch above it and use that as the trigger instead.

Choosing the right operator

You want to detect	Use
They filled in a text field at all	number of characters is greater than 0
They picked a specific value, single-select	is equal to
They picked a specific value, multi-select	contains
They picked several things	number of selections is greater than
They uploaded something	has file
They said yes to one thing	A Switch with is enabled
Their number is above a threshold	is greater than
They chose a particular Shopify variant	Shopify variant with is equal to — see Conditions based on Shopify variants