Simple Object Types

string

Text with no child properties: the empty string (""), a single character ("a"), or the full HTML output of a rendered template. When used alone in a conditional, every string evaluates as true — including "", "0", and "false".

Strings can be enumerated with {% for %}, in which case each item is a single character. For most other purposes a string is a single value, so {% if "string" is_list %} is false.

Example Every string, including "", "0", and "false", is truthy alonestring has no child properties; used alone in a conditional every string is truthy, even "", "0", and "false". {% for %} can enumerate a string's characters, but is_list still returns false.

{%- if "" -%}
	<p>the empty string is truthy alone</p>
{%- endif -%}
{%- if "0" -%}
	<p>"0" is truthy alone</p>
{%- endif -%}
{%- if "false" -%}
	<p>"false" is truthy alone</p>
{%- endif -%}
{%- if "cat" is_list -%}
	<p>a string is a list</p>
{%- else -%}
	<p>a string is not a list</p>
{%- endif -%}
<ul>
{%- for letter in "cat" -%}
	<li>{{ letter }}</li>
{%- endfor -%}
</ul>

string has no child properties. In a conditional, a string is tested for existence rather than compared to a boolean, so any string value evaluates as true when used alone, including the empty string, "0", and "false". {% for %} can enumerate a string's individual characters, but is_list still returns false because a string is treated as a single value for most other purposes.

integer

A whole number with no child properties, including 0 and negatives (for example -2, -1, 0, 1, 2). Integers are a type of number. Any integer — including 0 — evaluates as true when used alone in a conditional.

Example Zero and negative numbers are truthy alone; every integer is also a numberinteger and number have no child properties; used alone in a conditional any number, including 0, is truthy. Integers are a type of number.

{%- if 0 -%}
	<p>the integer 0 is truthy alone</p>
{%- endif -%}
{%- if -1 -%}
	<p>a negative integer is truthy alone</p>
{%- endif -%}
{%- if 0.0 -%}
	<p>the number 0.0 is truthy alone</p>
{%- endif -%}
{%- assign count = 3 -%}
{%- if count is_number -%}
	<p>{{ count }} is a number, since every integer is also a number</p>
{%- endif -%}

integer and number have no child properties. In a conditional, any number, including 0 or a negative value, evaluates as true when used alone, the same as any other value except explicit false or null. Integers are a type of number, so a value assigned as an integer, such as count here, also passes is_number.

number

A numeric value with no child properties: integers, decimals, or fractions, including 0. Integers are a type of number. Any number — including 0 — evaluates as true when used alone in a conditional.

Example Zero and negative numbers are truthy alone; every integer is also a numberinteger and number have no child properties; used alone in a conditional any number, including 0, is truthy. Integers are a type of number.

{%- if 0 -%}
	<p>the integer 0 is truthy alone</p>
{%- endif -%}
{%- if -1 -%}
	<p>a negative integer is truthy alone</p>
{%- endif -%}
{%- if 0.0 -%}
	<p>the number 0.0 is truthy alone</p>
{%- endif -%}
{%- assign count = 3 -%}
{%- if count is_number -%}
	<p>{{ count }} is a number, since every integer is also a number</p>
{%- endif -%}

integer and number have no child properties. In a conditional, any number, including 0 or a negative value, evaluates as true when used alone, the same as any other value except explicit false or null. Integers are a type of number, so a value assigned as an integer, such as count here, also passes is_number.

boolean

True or false. The literals true and false may be used anywhere a boolean value is used.

Example Use the true and false literals anywhere a boolean is expectedboolean has no child properties. The literals true and false may be used anywhere a boolean value is expected, including as a variable value or a condition operand.

{%- assign is_active = true -%}
{%- if is_active -%}
	<p>is_active is true</p>
{%- endif -%}
{%- assign is_hidden = false -%}
{%- if is_hidden == false -%}
	<p>is_hidden is false</p>
{%- endif -%}
{%- unless is_hidden -%}
	<p>unless treats false as the negative case</p>
{%- endunless -%}

boolean has no child properties; a value is simply true or false. The literals true and false may be used anywhere a boolean value is expected, whether assigned to a variable, compared with ==, or tested directly by {% if %} or {% unless %}.