...

Operators

...

It is possible use this operator with dynamic fields 'as is' only to compare strings.

Code Block

language	xml

{% if dynamicfields.name == 'alan' %} 
alan
{% elsif dynamicfields.name == 'tom' %}
tom
{% else %}
catherine
{% endif %}

In this case the check is case sensitive.

To compare numbers or data type different from string it is possible use the built in functions:

Code Block

language	xml

{% assign c1 = dynamicfields.name| evaltext: 'equalTo', 'Jennifer' %} {% if c1 == true %} Text {% endif %}

Code Block

language	xml

{% assign c1 = dynamicfields.age | evalinteger: 'equalTo', '8' %} {% if c1 == true %} Text {% endif %}

...

Introduction

The liquid is an open-source template language created by Shopify and written in Ruby. It is the backbone of Shopify themes and is used to load dynamic content on storefronts.

In MailUp Liquid is used as a markup language for the email messages that use Advanced content personalization.

The following guide describes how to use Liquid within MailUp and which statements are supported.

When talking about dynamics fields, we refer to the MailUp Recipient fields.

To retrieve a specific dynamic field value, you have to use the following syntax: dynamicfields.<dynamic field name>.

Note

In the liquid syntax, not all characters are supported in a variable name. To be sure to have a correct syntax when using MailUp dynamic field, we recommend using only:

digits (0...9)
letters (a...z and A...Z)
dash (-) and underscore (_) signs

For MailUp Recipient fields that contain these characters:

accented characters should be substituted with normalized characters (e.g. 'CrèmeBrûlée' -> 'CremeBrulee')
special characters, such as full stop (.), space (' '), dollar('$'), should be removed from the field name (e.g. 'Is a colleague' -> 'Isacolleague').

Basics

Operators

Operator

Meaning

Work

Syntax

==

equals

This operator can be used with dynamic fields 'as is' only to compare strings.

Code Block

language	xml

{% if dynamicfields.name

!

== 'alan' %} 
alan
{% elsif dynamicfields.name

!

== 'tom' %}
tom
{% else %}
catherine
{% endif %}

In this case, the check is case-sensitive.

To compare numbers or data

type

types different from a string it is possible to use the built-in functions:

Code Block

language	xml

{% assign c1 = dynamicfields.name| evaltext: '

otherThan

equalTo', 'Jennifer' %} {% if c1 == true %} Text {% endif %}

Code Block

language	xml

{% assign c1 = dynamicfields.age | evalinteger: '

otherThan

equalTo', '8' %} {% if c1 == true %} Text {% endif %}

>greater than

!=

does not equal

It is possible to use this operator with dynamic fields 'as is' only to compare strings.

Code Block

language	xml

{% if dynamicfields.name

>

!= 'alan' %} 
alan
{% elsif dynamicfields.name

>

!= 'tom' %}
tom
{% else %}
catherine
{% endif %}

In this case, the check is case-sensitive.

To compare numbers or data

type

types different from a string it is possible to use the built-in functions:

Code Block

language	xml

{% assign c1 = dynamicfields.name| evaltext: '

moreThan

otherThan', 'Jennifer' %} {% if c1 == true %} Text {% endif %}

Code Block

language	xml

{% assign c1 = dynamicfields.age | evalinteger: '

moreThan

otherThan', '8' %} {% if c1 == true %} Text {% endif %}

<less than

It is possible use

this operator with dynamic fields 'as is' only to compare strings

the operator to check if the dynamic field is empty or contains a value.

Code Block

language	xml

{% if dynamicfields.name

<

!= '

alan

' %}

alan {% elsif dynamicfields.name < 'tom' %} tom

Valued
{% else %}

catherine

empty
{% endif %}

In this case the check is case sensitive.

To compare numbers or data type different from string it is possible use the built

It is possible do the same using the built-in functions:

Code Block

language	xml

{% assign c1 = dynamicfields.name| evaltext: '

lessThan

otherThan', '

Jennifer

' %} {% if c1 == true %}

Text

valued {% endif %}

code>=greater than or equal to

>

language	xml

{% assign c1 = dynamicfields.age | evalinteger: 'lessThan', '8' %} {% if c1 == true %} Text {% endif %}

greater than

It is possible to use this operator with dynamic fields 'as is' only to compare strings.

Code Block

language	xml

{% if dynamicfields.name >

=

 'alan' %} 
alan
{% elsif dynamicfields.name >

=

 'tom' %}
tom
{% else %}
catherine
{% endif %}

In this case, the check is case-sensitive.

To compare numbers or data

type

types different from a string it is possible to use the built-in functions:

Code Block

language	xml

{% assign c1 = dynamicfields.name| evaltext: '

equalOrMoreThan

moreThan', 'Jennifer' %} {% if c1 == true %} Text {% endif %}

Code Block

language	xml

{% assign c1 = dynamicfields.age | evalinteger: '

equalOrMoreThan

moreThan', '8' %} {% if c1 == true %} Text {% endif %}

<

=

less than

or equal to

It is possible to use this operator with dynamic fields 'as is' only to compare strings.

Code Block

language	xml

{% if dynamicfields.name <

=

 'alan' %} 
alan
{% elsif dynamicfields.name <

=

 'tom' %}
tom
{% else %}
catherine
{% endif %}

In this case, the check is case-sensitive.

To compare numbers or data

type

types different from a string it is possible to use the built-in functions:

Code Block

language	xml

{% assign c1 = dynamicfields.name| evaltext: '

equalOrLessThan

lessThan', 'Jennifer' %} {% if c1 == true %} Text {% endif %}

Code Block

language	xml

{% assign c1 = dynamicfields.age | evalinteger: '

equalOrLessThan

lessThan', '8' %} {% if c1 == true %} Text {% endif %}

or

>=

logical

greater than or equal to

It is possible to use this operator with dynamic fields 'as is' only to compare strings.

Code Block

language	xml

{% if dynamicfields.name

=

>= 'alan'

or

%} 
alan
{% elsif dynamicfields.

age

name >=

=

child

tom' %}

is alan or a child

tom
{% else %}

It is an adult alan or another adult

catherine
{% endif %}

andlogical and

In this case, the check is case-sensitive.

To compare numbers or data types different from a string it is possible to use the built-in functions:

Code Block

language	xml

{% assign

if

c1 = dynamicfields.name|

==

evaltext: '

alan

equalOrMoreThan'

and dynamicfields.age == 'child

, 'Jennifer' %} {%

alan

if

is

c1

a child {% else

== true %}

it is an adult

Text {% endif %}

containschecks for the presence of a substring inside a string

Code Block

language	xml

{% assign

if

c1 = dynamicfields.

name contains

age | evalinteger: 'equalOrMoreThan', '

oof

8' %} {%

could

if

be

c1

alan?

== true

{

else %

surely isn't alan TypeMeaningWorkSyntaxStringDeclare a string by wrapping a variable’s value in single quotes:

Text {% endif %}

Types

<=

less than or equal to

It is possible to use this operator with dynamic fields 'as is' only to compare strings.

Code Block

language	xml

{%

assign

if

thisIsAString

dynamicfields.name <= '

this is a string

alan' %}

Code Block

language	xml
title	Output

THIS IS A STRING

NumberNumbers include floats and integers:

Code Block

language	xml


alan
{%

assign

elsif

thisIsAnInteger

dynamicfields.name <=

10

'tom' %}
tom
{

{ thisIsAnInteger | minus: 2 }} Code Block

language	xml
title	Output

8

% else %}
catherine
{% endif %}

In this case, the check is case-sensitive.

To compare numbers or data types different from a string it is possible to use the built-in functions:

Code Block

language	xml

{% assign

thisIsAFloat

c1 =

10.234

dynamicfields.name| evaltext: 'equalOrLessThan', 'Jennifer' %} {

{ thisIsAFloat | minus: 2 }}

% if c1 == true %} Text {% endif %}

Code Block

language	xml

titleOutput

8.23400020599365

Boolean

Code Block

language	xml

{% assign thisIsTrue =

{% assign c1 = dynamicfields.age | evalinteger: 'equalOrLessThan', '8' %} {% if c1 == true %} Text {

{

thisIsTrue

endif %}

}

code

or

language	xml
title	Output

true

logical or

Code Block

language	xml

{%

assign thisIsFalse = true

 if dynamicfields.name == 'alan' or dynamicfields.age == 'child' %}

Code Block

language	xml
title	Output

false

Nil

Nil is a special empty value that is returned when Liquid code has no results. It is not a string with the characters “nil”.

Nil is treated as false in the conditions of if blocks and other Liquid tags that check the truthfulness of a statement.

Code Block

language	xml

{% if user %} Hello user!


is alan or a child
{% else %}
It is an adult alan or another adult
{% endif %}

code

and

language	xml
title	Output

logical and

Code Block

language	xml

{%

unless user

 if dynamicfields.name == 'alan' and dynamicfields.age == 'child' %} 
alan is a child
{% else %}
it is

Hello

an

user!

adult
{%

endunless

endif %}

contains

checks for the presence of a substring inside a string

Code Block

language	xml

titleOutput

 Hello user!

ArrayArrays hold lists of variables of any type.

Code Block

language	xml

{% assign my_array = 'alan,catherine,tom,erin,mark' | split: ',' %}
{{ my_array.first }}
{{ my_array.last }}

Code Block

language	xml
title	Output

alan mark

{% if dynamicfields.name contains 'oof' %} 
could be alan? 
{% else %} 
surely isn't alan 
{% endif %}

Types

Type

Meaning

Work

Syntax

String

Declare a string by wrapping a variable’s value in single quotes:

Code Block

language	xml
title	Input

{% assign

my_array

thisIsAString = '

alan,catherine,tom,erin,mark' | split: ','

this is a string' %}
{

%

for

thisIsAString

user in my_array %} {{ user

| upcase }}

{%

endfor %}

Code Block

language	xml
title	Output

alan

THIS

catherine

IS

tom erin mark

A STRING

Number

Numbers include floats and integers:

Code Block

language	xml
title	Input

{% assign

my_array

thisIsAnInteger =

'alan,catherine,tom,erin,mark' | split: ','

10 %}
{{

my_array[2]

 thisIsAnInteger | minus: 2 }}

Code Block

language	xml
title	Output

tom

Code Block

language

...

xml

...

OperatorMeaningWorkSyntaxcommentAny text within the opening and closing comment blocks will not be output, and any Liquid code within will not be executed

title

Comment

Input

{% assign thisIsAFloat = 10.234 %}
{{ thisIsAFloat  | minus: 2 }}

Code Block

language	xml
title	Output

8.23400020599365

Boolean

Code Block

language	xml

Text 1 {% comment %} Text 2 {% endcomment %}

title	Input

{% assign thisIsTrue = true %}
{{ thisIsTrue }}

Code Block

language	xml
title	Output

Text 1

OperatorMeaningWorkSyntaxifExecutes a block of code only if a certain condition is

Control flow

true

Code Block

language	xml
title	Input

{% assign

c1

thisIsFalse =

dynamicfields.age| evalinteger: 'equalTo', '10'

true %}

{{

% if c1 == true %} 10 years old {% endif %

 thisIsFalse }}

Code Block

language	xml
title	Output

10 years old

Code Block

language	xml

{% if dynamicfields.name == 'alan' %} alan

false

Nil

Nil is a special empty value that is returned when the Liquid code has no results. It is not a string with the characters “nil”.

Nil is treated as false in the conditions of if blocks and other Liquid tags that check the truthfulness of a statement.

Code Block

language	xml
title	Input

{% if user %}
  Hello user!
{% endif %}

Code Block

language	xml
title	Output

alancode

 Hello user!

Code Block

unlessExecutes a block of code only if a certain condition is not match

language	xml
title	Input

{%

assign

unless

c1

user

= dynamicfields.age| evalinteger: 'equalTo', '10' %} {% unless c1 == true %} Not 10 years old {%

%}
  Hello user!
{% endunless %}

Code Block

language	xml
title	Output

Not 10 years old

 Hello user!

Array

Arrays hold lists of variables of any type.

Code Block

language	xml
title	Input

{%

unless dynamicfields.name

assign my_array =

=

 'alan,catherine,tom,erin,mark'

%}

| split:

alan

','

{

%}

endunless %

{{ my_array.first }}
{{ my_array.last }}

Code Block

language	xml
title	Output

alan

elsif/elseAdds more conditions within an if or unless block.

mark

Code Block

language	xml
title	Input

{%

if dynamicfields.name =

assign my_array = 'alan,catherine,tom,erin,mark' | split: ',' %}

alan

{%

elsif

for

dynamicfields.name == 'tom'

user in my_array %}

tom

%

else

user

%

}}

catherine {

{%

endif

alan

Code Block

language	xml
title	output if name is mickey

tom

endfor %}

Code Block

title
language	xml

output if name is goofyCreates a switch statement to compare a variable with different values

code

Output

alan catherine tom erin mark

Code Block

title
language	xml

output for each other name

catherine

case/when

Input

{%

case dynamicfields.name%} {% when 'alan

assign my_array = 'alan,catherine,tom,erin,mark' | split: ',' %}

This is a alan {% when 'tom' %} This is a tom {% else %} This is not a alan nor a tom. can it be a catherine? {% endcase %}

{{ my_array[2] }}

Code Block

language	xml
title	Output

tom

Filters

TBD

OperatorMeaningWorkSyntaxabs

Returns the absolute value of a number.

append

Concatenates two strings and returns the concatenated value.

Code Block

title	Input

{{ "Hello " | append: "Carl" }}

Code Block

title	Output

Hello Carl

Code Block

title	Input

{{ "Welcome" | append: dynamicfields.name }}

Code Block

title	Output

Welcome Luke

Code Block

title	Input

{{ dynamicfields.name | append: " welcome!"}}

Code Block

title	Output

Luke welcome!

at_least

Limits a number to a minimum value.

at_most

Limits a number to a maximum value.

capitalize

Makes the first character of a string capitalized.

Code Block

title	Input

{{ "my great title" | capitalize }}

Code Block

title	Output

My great title

Code Block

title	Input

{{ dynamicfields.nome | capitalize }}

Code Block

title	Output

Luke

ceil

Rounds the input up to the nearest whole number. Liquid tries to convert the input to a number before the filter is applied.

compact

Removes any nil values from an array.

concat

Concatenates (joins together) multiple arrays. The resulting array contains all the items from the input arrays.

dateConverts a timestamp into another date format. The format for this syntax is the same as strftime. The input uses the same format as Ruby’s Time.parse. defaultAllows you to specify a fallback in case a value doesn’t exist. defaultwill show its value if the left side is nil, false, or empty.

divided_byDivides a number by the specified

alan

Cycle

Operator

Meaning

Work

Syntax

Cycle

Repeatedly executes a block of code.

Code Block

language	xml
title	Input

{% assign my_array = 'alan,catherine,tom,erin,mark' | split: ',' %}
{% for user in my_array %}
 {% cycle 'first one', 'second one', 'third one' %} 
{% endfor %}

Code Block

language	xml
title	Output

first one second one third one first one second one

Variable

Operator Meaning Work Syntax

assign

Creates a new variable

Code Block

language	xml
title	Input

{% assign c1 = 10 %}
{% if c1 == 10 %} 
    It is ten!
{% endif %}

Code Block

language	xml
title	Output

It is ten!

Code Block

language	xml
title	Input

{% assign c1 = 'alan' %}
{% if c1 == 'alan' %} 
   It is alan!
{% endif %}

Code Block

language	xml
title	Output

It is alan!

capture

Captures the string inside of the opening and closing tags and assigns it to a variable. Variables created through {% capture %} are strings.

Code Block

language	xml
title	Input

{% assign name = dynamicfields.name %}
{% assign surname = dynamicfields.surname %}

{% capture about_me %}
I am {{ name }} {{ surname }} and my favorite food is pizza.
{% endcapture %}

{{ about_me }}

Code Block

language	xml
title	output

I am Catherine Martin and my favorite food is pizza.

increment Creates a new number variable, and increases its value by one every time it is called. The initial value is 0.

decrement Creates a new number variable, and decreases its value by one every time it is called. The initial value is -1.

Filters

...

Operator Meaning Work Syntax

abs

Returns the absolute value of a number.

append

Concatenates two strings and returns the concatenated value.

Code Block

title	Input

{{ "Hello " | append: "Carl" }}

Code Block

title	Output

Hello Carl

Code Block

title	Input

{{ "Welcome" | append: dynamicfields.name }}

Code Block

title	Output

Welcome Luke

Code Block

title	Input

{{ dynamicfields.name | append: " welcome!"}}

Code Block

title	Output

Luke welcome!

at_least

Limits a number to a minimum value.

at_most

Limits a number to a maximum value.

capitalize

Makes the first character of a string capitalized.

Code Block

title	Input

{{ "my great title" | capitalize }}

Code Block

title	Output

My great title

Code Block

title	Input

{{ dynamicfields.nome | capitalize }}

Code Block

title	Output

Luke

ceil

Rounds the input up to the nearest whole number. Liquid tries to convert the input to a number before the filter is applied.

compact

Removes any nil values from an array.

concat

Concatenates (joins together) multiple arrays. The resulting array contains all the items from the input arrays.

date Converts a timestamp into another date format. The format for this syntax is the same as strftime. The input uses the same format as Ruby’s Time.parse.

default Allows you to specify a fallback in case a value doesn’t exist. defaultwill show its value if the left side is nil, false, or empty.

divided_by

Divides a number by the specified number.

Does not work on dynamicfields.

Code Block

title	Input

{{ 16 | divided_by: 4 }}

Code Block

title	Output

Code Block

title	Input

{{ subTotal| divided_by: 4 }}

Code Block

title	Output

downcase

Makes each character in a string lowercase. It does not affect strings that are already all lowercase.

Code Block

title	Input

{{ "Parker Moore" | downcase }}

Code Block

title	Output

parker moore

Code Block

title	Input

{{ dynamicfields.nome | downcase}}

Code Block

title	Output

luke

escape

Escapes a string by replacing characters with escape sequences (so that the string can be used in a URL, for example). It doesn’t change strings that don’t have anything to escape.

escape_once

Escapes a string without changing existing escaped entities. It doesn’t change strings that don’t have anything to escape.

first

Returns the first item of an array.

Assuming the userid dynamicfield contains "1,2,3,4,5".

Code Block

title	Input

{% assign my_array = dynamicfields.userid | split: "," %}
{{ my_array.first }}

Code Block

title	Output

Code Block

title	Input

{% assign my_array = "apples, oranges, peaches, plums" | split: ", " %}
{{ my_array.first }}

Code Block

title	Output

apples

floor

Rounds a number down to the nearest whole number. Liquid tries to convert the input to a number before the filter is applied.

join

Combines the items in an array into a single string using the argument as a separator.

Assuming the userid dynamicfield contains "1,2,3,4,5".

Code Block

title	Input

{% assign my_array = dynamicfields.userid | split: "," %}
{{ my_array | join: " and " }}

Code Block

title	Output

1 and 2 and 3 and 4 and 5

Code Block

title	Input

{% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
{{ beatles | join: " and " }}

Code Block

title	Output

John and Paul and George and Ringo

last

Returns the last item of an array.

Assuming the userid dynamicfield contains "1,2,3,4,5".

Code Block

title	Input

{% assign my_array = dynamicfields.userid | split: "," %}
{{ my_array.last}}

Code Block

title	Output

Code Block

title	Input

{% assign my_array = "apples, oranges, peaches, plums" | split: ", " %}

{{ my_array.last }}

Code Block

title	Output

plums

lstrip

Removes all whitespaces (tabs, spaces, and newlines) from the beginning of a string. The filter does not affect spaces between words.

map

Creates an array of values by extracting the values of a named property from another object.

Assuming the products contains:

Code Block

language	java

{
	"products": [{
		"title": "Product 1",
		"price": 100
	}, {
		"title": "Product 2",
		"price": 200
	}, {
		"title": "Product 3",
		"price": 300
	}]
}

Code Block

title	Input

{% assign all_titles = products | map: "title" %}

{% for item in all_titles %}
{{ item }}
{% endfor %}

Code Block

title	Output

Product 1
Product 2
Product 3

minus

Subtracts a number from another number.

Does not work on dynamicfields.

Code Block

title	Input

{{

16

4 |

divided_by

minus:

4

2 }}

Code Block

title	Output

Code Block

title	Input

{{

subTotal

SubTotal |

divided_by

minus:

4

100 }}

Code Block

title	Output

100

downcase

Makes each character in a string lowercase. It has no effect on strings which are already all lowercase.

modulo

Returns the remainder of a division operation.

Does not work on dynamicfields.

Code Block

title	Input

{{

"Parker

Moore"

|

modulo:

downcase

2 }}

Code Block

title	Output

parker moore

Code Block

title	Input

{{

dynamicfields.nome

SubTotal |

downcase

modulo: 6}}

Code Block

title	Output

luke

escapeEscapes a string by replacing characters with escape sequences (so that the string can be used in a URL, for example). It doesn’t change strings that don’t have anything to escape

newline_to_br

Replaces every newline (\n) with an HTML line break (<br>).

escape_once

Escapes a string without changing existing escaped entities. It doesn’t change strings that don’t have anything to escape.

first

Returns the first item of an array.

Assuming the userid dynamicfield contains "1,2,3,4,5"

plus

Adds a number to another number.

Assuming the TotalIncome dynamic field contains 500.

Code Block

title	Input

% assign my_array =

{ dynamicfields.

userid

TotalIncome|

split: "," %} {{ my_array.first

plus: 2 }}

Code Block

title	Output

Code Block

title	Input

{{

% assign my_array = "apples, oranges, peaches, plums" | split: ", " %} {{ my_array.first

 5| plus: 2 }}

Code Block

title	Output

apples

floor

Rounds a number down to the nearest whole number. Liquid tries to convert the input to a number before the filter is applied.

join

Combines the items in an array into a single string using the argument as a separator.

Assuming the userid dynamicfield contains "1,2,3,4,5".

prepend

Adds the specified string to the beginning of another string.

Code Block

title	Input

%

assign my_array = dynamicfields.userid | split: "," %} {{ my_array | join: " and

"apples, oranges, and bananas" | prepend: "Some fruit: " }}

Code Block

title	Output

Some fruit: apples, oranges, and bananas

Code Block

title	Input

{{ dynamicfields.Name| prepend: "Hello " }}

Code Block

title	Output

1 and 2 and 3 and 4 and 5

Hello Luke

Code Block

title	Input

% assign beatles = "John, Paul, George, Ringo" | split: ", " %} {{ beatles | join: " and " }}

{ dynamicfields.Name| prepend: dynamicfields.Surname}}

Code Block

title	Output

Luke Skywalker

Code Block

title	Input

{{ "Welcome" | prepend: dynamicfields.Name }}

Code Block

title	Output

John and Paul and George and Ringo

last

Returns the last item of an array.

Assuming the userid dynamicfield contains "1,2,3,4,5".

Welcome Luke

remove

Removes every occurrence of the specified substring from a string.

Code Block

title	Input

{{ "I strained to see the train through the rain" | remove: "rain" }}

Code Block

title

Input{% assign my_array = dynamicfields.userid | split: "," %} {{ my_array.last

Output

I sted to see the t through the

Code Block

title	Input

{{ dynamicfields.Name| remove: "uk"}}

Code Block

title	Output

Le

Code Block

title	Input

{{"Luke Skywalker" | remove: dynamicfields.Name}}

Code Block

title	Output

Skywalker

remove_first

Removes only the first occurrence of the specified substring from a string.

Code Block

title	Input

{{

% assign my_array = "apples, oranges, peaches, plums

 "I strained to see the train through the rain" |

split

remove_first: "

, " %} {{ my_array.last }}

Code Block

title	Output

plums

lstrip

Removes all whitespaces (tabs, spaces, and newlines) from the beginning of a string. The filter does not affect spaces between words.

TODO: dovrebbe funzionaremap

Creates an array of values by extracting the values of a named property from another object.

minus

Subtracts a number from another number.

Does not work on dynamicfields.

rain" }}

Code Block

title	Output

I sted to see the train through the rain

replace

Replaces every occurrence of an argument in a string with the second argument.

Code Block

title	Input

{{

4

 "Take my protein pills and put my helmet on" |

minus

replace:

2

 "my", "your" }}

Code Block

title	Output

Take your protein pills and put your helmet on

replace_first

Replaces only the first occurrence of the first argument is a string with the second argument.

Code Block

title	Input

{ SubTotal | minus: 100

% assign my_string = "Take my protein pills and put my helmet on" %}
{{ my_string | replace_first: "my", "your" }}

Code Block

title	Output

modulo

Returns the remainder of a division operation.

Does not work on dynamicfields.

Code Block

title	Input

{{ 3 | modulo: 2 }}

Code Block

title	Output

Take your protein pills and put my helmet on

reverse

Reverses the order of the items in an array. reverse cannot reverse a string.

round

Rounds an input number to the nearest integer or, if a number is specified as an argument, to that number of decimal places.

Does not work on dynamicfields.

Code Block

title	Input

{{

SubTotal

1.2 |

modulo:

round

6

}}

Code Block

title	Output

newline_to_br

Replaces every newline (\n) with an HTML line break (<br>).

plus

Adds a number to another number.

Assuming the TotalIncome dynamic field contains 500.

rstrip

Removes all whitespace (tabs, spaces, and newlines) from the right side of a string.

size

Returns the number of characters in a string or the number of items in an array. size can also be used with dot notation (for example, {{ my_string.size }}). This allows you to use size inside tags such as conditionals.

Code Block

title	Input

{{

dynamicfields.TotalIncome| plus: 2 }}

Code Block

title	Output

Code Block

title	Input

{{ 5| plus: 2

"Ground control to Major Tom." | size }}

Code Block

7

title

prepend

Adds the specified string to the beginning of another string.

Output

Code Block

title	Input

{

% assign my_array = "apples, oranges,

and

peaches,

bananas

plums" |

prepend

split: "

Some fruit: "

, " %}

{{ my_array | size }}

Code Block

title	Output

Some fruit: apples, oranges, and bananas

slice

Returns a substring of 1 character beginning at the index specified by the argument passed in. An optional second argument specifies the length of the substring to be returned.

String indices are numbered starting from 0.

Code Block

title	Input

{{

dynamicfields.Name

 "Liquid" |

prepend

slice:

"Hello "

0 }}

Code Block

title	Output

Hello Luke

Assuming title contains "Return to the future"

Code Block

title	Input

{{title

dynamicfields.Name

prepend

slice:

dynamicfields.Surname

0}}

Code Block

title	Output

Luke Skywalker

Code Block

title	Input

{{

"Welcome"

dynamicfields.title|

prepend

slice:

dynamicfields.Name

0 }}

Code Block

title	Outuput

Output

Welcome Luke

remove

Removes every occurrence of the specified substring from a string.

sort

Sorts items in an array by a property of an item in the array. The order of the sorted array is case-sensitive.

Same behavior of the sort_natural filter.

Code Block

title	Input

{

"I strained to see the train through the rain" | remove: "rain" }}

Code Block

title	Output

I sted to see the t through the

Code Block

title	Input

{{ dynamicfields.Name| remove: "uk"

assign my_array = "zebra, octopus, giraffe, Sally Snake" | split: ", " %}

{{ my_array | sort_natural | join: ", " }}

Code Block

title	Output

Le

Code Block

title	Input

{{"Luke Skywalker" | remove: dynamicfields.Name}}

Code Block

title	Output

Skywalker

remove_firstRemoves only the first occurrence of the specified substring from a string

giraffe, octopus, Sally Snake, zebra

sort_natural Sorts items in an array by a property of an item in the array.

split

Divides an input string into an array using the argument as a separator. split is commonly used to convert comma-separated items from a string to an array.

Code Block

title	Input

{ "I strained to see the train through the rain" | remove_first: "rain" }

% assign beatles = "John, Paul, George, Ringo" | split: ", " %}
{% for member in beatles %}
{{ member }}
{% endfor %}

Code Block

title	Output

I

John

sted

to

Paul

see

the

George

train

through the rainreplace

Replaces every occurrence of an argument in a string with the second argument.

Ringo

Assuming the dynamic field albumid contains "1,2,3,4,5"

Code Block

title	Input

{ "Take my protein pills and put my helmet on"

% assign ids= dynamicfields.albumid |

replace

split:

"my

",

"your

}}

Code Block

title	Output

Take your protein pills and put your helmet on

TODO: aggiungere esempi con campi dinamici!

replace_first

Replaces only the first occurrence of the first argument in a string with the second argument.

reverse

Reverses the order of the items in an array. reverse cannot reverse a string.

round

Rounds an input number to the nearest integer or, if a number is specified as an argument, to that number of decimal places.

rstrip

%}
{% for id in ids%}
{{ id }}
{% endfor %}

Code Block

title	Output

strip

Removes all whitespace (tabs, spaces, and

newlines) from the right side of

newlines) from both the left and right sides of a string. It does not affect spaces between words.
strip_html	Removes any HTML tags from a string.

TODO: dovrebbe funzionaresize

Returns the number of characters in a string or the number of items in an array. size can also be used with dot notation (for example, {{ my_string.size }}). This allows you to use size inside tags such as conditionals.

slice

Returns a substring of 1 character beginning at the index specified by the argument passed in. An optional second argument specifies the length of the substring to be returned.

String indices are numbered starting from 0.

sort

Sorts items in an array by a property of an item in the array. The order of the sorted array is case-sensitive.

sort_naturalSorts items in an array by a property of an item in the array. splitDivides an input string into an array using the argument as a separator. split is commonly used to convert comma-separated items from a string to an array.

strip

Removes all whitespace (tabs, spaces, and newlines) from both the left and right side of a string. It does not affect spaces between words.

TODO: dovrebbe funzionarestrip_html

Removes any HTML tags from a string.

strip_newlines

Removes any newline characters (line breaks) from a string.

times

Multiplies a number by another number.

truncate

truncate shortens a string down to the number of characters passed as a parameter. If the number of characters specified is less than the length of the string, an ellipsis (…) is appended to the string and is included in the character count.

Code Block

title	Input

{{ "Have <em>you</em> read <strong>Ulysses</strong>?" | strip_html }}

Code Block

title	Output

Have you read Ulysses?

strip_newlines

Removes any newline characters (line breaks) from a string.

times

Multiplies a number by another number.

Does not work on dynamicfields.

Code Block

title	Input

{{ 24 | times: 7 }}

Code Block

title	Output

truncate

truncate shortens a string down to the number of characters passed as a parameter. If the number of characters specified is less than the length of the string, an ellipsis (…) is appended to the string and is included in the character count.

Code Block

title	Input

{{ "Ground control to Major Tom." | truncate: 20 }}

Code Block

title	Output

Ground control to...

Code Block

title	Input

{{ "Ground control to Major Tom." | truncate: 25, ", and so on" }}

Code Block

title	Output

Ground control, and so on

truncatewords

Shortens a string down to the number of words passed as the argument. If the specified number of words is less than the number of words in the string, an ellipsis (…) is appended to the string.

TODO: dovrebbe funzionare


uniq	Removes any duplicate elements in an array.


upcase	Makes each character in a string uppercase. It

has no effect on strings which

does not affect strings that are already all uppercase.

Code Block

title	Input

{{ dynamicfields.name | upcase }}

Code Block

title	Output

LUKE

url_decode

Decodes a string that has been encoded as a URL or by url_encode.


url_encode	Converts any URL-unsafe characters in a string into percent-encoded characters.

Versions Compared

Old Version 36

New Version Current

Key

Operators

Introduction

Basics

Operators

Types

Types

Comment

Control flow

TAGS

Comment

Control flow

Iteration

For

Iteration

For

Cycle

Tablerow

Filters

Cycle

Variable

Filters

Page Comparison

Versions Compared

Old Version 36

New Version Current

Key

<span class="diff-html-changed" data-a11y-before="Start of changed content" data-a11y-after="End of changed content" id="changed-diff-0">[data-colorid=</span>

<span class="diff-html-added" data-a11y-before="Start of added content" data-a11y-after="End of added content" id="added-diff-0">aetfdgmgd3</span><span class="diff-html-changed" data-a11y-before="Start of changed content" data-a11y-after="End of changed content" id="changed-diff-1">]{color:</span>

<span class="diff-html-added" data-a11y-before="Start of added content" data-a11y-after="End of added content" id="added-diff-2">aetfdgmgd3</span><span class="diff-html-changed" data-a11y-before="Start of changed content" data-a11y-after="End of changed content" id="changed-diff-3">]{color:</span>

Operators

Introduction

Basics

Operators

Types

Types

Comment

Control flow

TAGS

Comment

Control flow

Iteration

For

Iteration

For

Cycle

Tablerow

Filters

Cycle

Variable

Filters