Shopify Liquid Operators & Controls

Shopify Liquid operators & controls allow developers to create conditional logic, loops, and comparisons inside Shopify themes. This guide covers all essential operators with examples!

Shopify Liquid Operators

Liquid includes many logical and comparison operators. You can use operators to create logic with control flow tags.

Operator Description Example

Operator	Description	Example
`==`	Equal to	`{% if product.type == "Shirt" %} Match {% endif %}`
`!=`	Not equal to	`{% if product.type != "Pants" %} Not Pants {% endif %}`
`>`	Greater than	`{% if product.price > 20 %} Expensive {% endif %}`
`<`	Less than	`{% if product.price < 10 %} Cheap {% endif %}`
`>=`	Greater than or equal	`{% if product.price >= 50 %} Premium {% endif %}`
`< =`	Less than or equal	`{% if product.price ⇐ 5 %} Very Cheap {% endif %}`
`or`	One condition must be true	`{% if customer or cart.item_count > 0 %} Welcome {% endif %}`
`and`	Both conditions must be true	`{% if product.available and product.price > 10 %} Buy Now {% endif %}`
`contains`	Checks if a string or array contains a value	`{% if product.tags contains "Sale" %} Discounted! {% endif %}`

==

Equal to

{% if product.type == "Shirt" %} Match {% endif %}

!=

Not equal to

{% if product.type != "Pants" %} Not Pants {% endif %}

>

Greater than

{% if product.price > 20 %} Expensive {% endif %}

<

Less than

{% if product.price < 10 %} Cheap {% endif %}

>=

Greater than or equal

{% if product.price >= 50 %} Premium {% endif %}

< =

Less than or equal

{% if product.price ⇐ 5 %} Very Cheap {% endif %}

or

One condition must be true

{% if customer or cart.item_count > 0 %} Welcome {% endif %}

and

Both conditions must be true

{% if product.available and product.price > 10 %} Buy Now {% endif %}

contains

Checks if a string or array contains a value

{% if product.tags contains "Sale" %} Discounted! {% endif %}

Control Flow Statements

Control flow tags create conditions that decide whether blocks of Liquid code get executed.

`if` Statement

Executes a block of code only if a certain condition is true.

Code

{% if product.title == "Awesome Shoes" %}
  These shoes are awesome!
{% endif %}

Output

These shoes are awesome!

`if else` Statement

if a certain condition is true then do something otherwise do other things.

Code

{% if product.title == "Awesome Shoes" %}
  These shoes are awesome!
{% else %}
  Regular shoes
{% endif %}

Output

Regular shoes

`elsif / else` Statement

Adds more conditions within an if or unless block.

Code

<!-- If customer.name = "anonymous" -->
{% if customer.name == "kevin" %}
  Hey Kevin!
{% elsif customer.name == "anonymous" %}
  Hey Anonymous!
{% else %}
  Hi Stranger!
{% endif %}

Output

Hey Anonymous!

`unless` Statement

The opposite of if – executes a block of code only if a certain condition is not met.

Code

{% unless product.title == "Awesome Shoes" %}
  These shoes are not awesome.
{% endunless %}

Output

These shoes are not awesome.

This would be the equivalent of doing the following:

{% if product.title != "Awesome Shoes" %}
  These shoes are not awesome.
{% endif %}

`case/when` Statement

The case statement is used for conditional branching, similar to switch in other programming languages.
when keyword is used to match the condition.
A when tag can accept multiple values.
If a when condition matches the variable, its corresponding block of code is executed.
The else (or else case) is optional and runs if no when conditions match.

Code

{% assign handle = "cake" %}
{% case handle %}
  {% when "cake" %}
     This is a cake
  {% when "cookie", "biscuit" %}
     This is a cookie
  {% else %}
     This is not a cake nor a cookie
{% endcase %}

Output

This is a cake

Shopify Liquid Operators & Controls