default

v1.9.1

Allows you to specify a fallback in case a value doesn’t exist. default will show its value if the left side is falsy or empty (string or Array).

In this example, product_price is not defined, so the default value is used.

Input

{{ product_price | default: 2.99 }}

Output

2.99

In this example, product_price is defined, so the default value is not used.

Input

{% assign product_price = 4.99 %}
{{ product_price | default: 2.99 }}

Output

4.99

In this example, product_price is empty, so the default value is used.

Input

{% assign product_price = "" %}
{{ product_price | default: 2.99 }}

Output

2.99

Allowing false

v9.32.0

To allow variables to return false instead of the default value, you can use the allow_false parameter.

Input

{% assign display_price = false %}
{{ display_price | default: true, allow_false: true }}

Output

false