Liquid syntax list

{% cio_link url:https://example.com %}
{% cio_link url:https://example.com track:true url_params:true %}
{% cio_link url:https://example.com track:true url_params:false %}
{% cio_link url:https://example.com track:false url_params:true %}
{% cio_link url:https://example.com track:false url_params:false %}

https://e.customeriomail.com/e/c/{string}
https://e.customeriomail.com/e/c/{string}
https://e.customeriomail.com/e/c/{string}
https://example.com?utm_campaign={string}&utm_content={string}&utm_medium={string}&utm_source=customer.io
https://example.com

<a href="https://yourwebsite.com/confirm?link_id={% cio_link_id %}" class="untracked">Text</a>

{{customer.<attribute_name>}}

Hi {{ customer.first_name | default: "there" }}

{% if customer.first_name != blank %}
  Hello {{ customer.first_name }}!
{% else %}
  Hello there!
{% endif %}

{{event.<property>}}

{% if event.type == "purchase" %}
  Thanks for your purchase!
{% else %}
  Thanks for using our service!
{%endif%}

{{event_id}}

{{event_name}}

{{event_timestamp}}

{{journey.<attribute_name>}}

{% if journey.weather != blank %}
  Here's the forecast for the day: {{journey.weather}}!
{% else %}
  Check out your forecast online at...
{%endif%}

{{objects.<object-type-name>[#].<object-attribute-name>}} // reference an object attribute
{{objects.<object-type-name>[#].relationship.<relationship-attribute-name>}} // reference a relationship attribute
{{customer._relationship.<relationship-attribute-name>}} // reference a relationship attribute for the audience member of object or relationship-triggered campaigns

// list all online classes that a person has not started
{% for class in objects.online_classes %}
{% if class.relationship.status == "not_started" %}
  - {{class.name}}
{% endif %}
{% endfor %}

{% render_liquid <liquid-key-name>.<attribute_name> %}

{% render_liquid journey.body %}

{{snippets.footer}}

// For transactional messages, webhook-triggered campaigns, or API-triggered broadcasts
{{trigger.<data.property>}}

// For object-triggered campaigns
{{trigger.<object_type>.<attribute_name>}}

// For object or relationship-triggered campaigns
{{trigger.relationship.<attribute_name>}}

{% if trigger.first_name %}
  Hi {{trigger.first_name | capitalize}}!
{% else %}
  Hi friend!
{%endif%}

{% view_in_browser_url %}

{% manage_subscription_preferences_url %}

{% tracking_consent_url %}

{% unsubscribe %}

{% unsubscribe_url %}

{{campaign.id}}

{{campaign.name}}

{{campaign.subscription_topic_ids}}

{{campaign.type}}

{{content}}

{{delivery_id}}

{{editor}}

{{layout.id}}

{{layout.name}}

{{message.id}}

{{message.journey_id}}

{{message.name}}

{{message.preheader}}

{{message.send_to_unsubs}}

{{message.subject}}

{{message.subscription_topic_ids}}

{{message.subscription_topic.name}}
{{message.subscription_topic.name | default: "Unsubscribe"}}

{{message.type}}

{% subscription_topic_name %}
{% subscription_topic_name lang='pt' %}

{% assign var_name = 'value' %}

{% assign favorite_food = 'apples' %}

{{ favorite_food }}

{% capture about_me %}I am 28 and my favorite food is pasta.{% endcapture %}

{{ about_me }}

<ul>{% assign characters = "coyote,bugs,tweety" | split: "," %}
  {% for character in characters %}
  <li class="{% cycle 'odd', 'even' %}">{{ character }}</li>
  {% endfor %}
</ul>

<ul>
  <li class='odd'>coyote</li>
  <li class='even'>bugs</li>
  <li class='odd'>tweety</li>
</ul>

{% for item in array %}
  {{ item }}
{% endfor %}

{% comment %} You can use a break tag so the loop stops iterating. {% endcomment %}
{% for i in (1..5) %}
  {% if i == 4 %}
    {% break %}
  {% else %}
    {{ i }}
  {% endif %}
{% endfor %}

{% comment %} You can output each item of the array. {% endcomment %}
{% for member in members_of_band %}
  {{member}}
{% endfor %}

{% comment %} If the items are objects, you can output properties from each object. {% endcomment %}
{% for product in event.products %}
  - {{ product.title }} x {{ product.price }}
{% endfor %}

{% case condition %}
  {% when "value1" %}
    text when condition is value1.
  {% when "value2" or "value3" %}
    text when condition is value2 or value3
  {% else %}
    text when condition does not match other conditions
{% endcase %}

{% if customer.lastEventType == "sports" %}
  You last attended a sports event, so we thought you might like to try out our leagues! Fill out our interest form below.
{% elsif customer.lastEventType == "theater" %}
  You attended a theater event, so we thought you might like to try out our after show parties! Fill out our interest form below.
{% elsif customer.lastEventType %}
  {% comment %} If the attribute exists and does not equal sports or theater, then this will render.{% endcomment %}
  You last attended {{customer.lastEventType}}; we'd love to hear what other offerings you'd like from us in the form below.
{% else %}
  {% comment %} If the attribute does not exist, this will render. {% endcomment %}
  Let us know your interests in the form below so we can better serve you!
{% endif %}

{% unless product.name == "cool beans" %}
  The beans are not cool.
{% endunless %}

{% if condition1 and condition2 %}
  // do something if both condition1 and condition 2 are true
{% endif %}

{% if customer.name == "bugs bunny" and event.episode_start == true %}
  What's up doc?
{% else %}
  That's all folks!
{% endif %}

{% if customer.name != "daffy duck" %}
  Duck season!
{% else %}
  Wabbit season!
{%endif%}

{% if customer.name == "daffy duck" %}
  Wabbit season!
{% else %}
  Duck season!
{% endif %}

{% if val1 > val2 %}
  {% comment %}do something if val1 is greater than val2{% endcomment %}
{% endif %}

{% if customer.acct_age_years > 1 %}
  Thanks for being with us these past years
{% else %}
  Thanks for spending the last year with us!
{% endif %}

{% if val1 < val2 %}
  {% comment %}do something if val1 is less than val2{% endcomment %}
{% endif %}

{% if customer.purchases < 5 %}
  Thanks for your support
{% else %}
  Thanks for spending the last year with us!
{% endif %}

{% if condition1 or condition2 %}
  {% comment %}do something if either condition1 and condition 2 are true{% endcomment %}
{% endif %}

{% if customer.name == "bugs bunny" or customer.group == "looney toons" %}
  That's all folks!
{% else %}
  See you later!
{% endif %}

{{ <unix_timestamp> | add_day: <int_days> }}

{{ 1477430251 | add_day: 7 }}

{{ <unix_timestamp> | add_month: <int_months> }}

{{ 1477430251 | add_month: 7 }}

{{ <unix_timestamp> | add_year: <int_years> }}

{{ 1477430251 | add_year: 4 }}

{% countdown point:64 font:roboto weight:light fg:000000 bg:f2f6f9 time:"2022-07-04 12:00:00 (GMT)" locale:en looping:true resolution:S frames:2 %}

{{ 1483272000 | date: '%H:%M, %a, %b %d, %Y' }}
{{ 1483272000 | date: '%a., %-m/%d at %I:%M %P %Z' }}
{{ "1990-12-31T23:00:00Z" | date: "%Y-%m-%dT%H:%M:%S", "Asia/Colombo" }}
{{ "1990-12-31T23:00:00Z" | date: "%Y-%m-%dT%H:%M:%S", 360 }}

12:00, Sun, Jan 01, 2017
Sun., 1/01 at 12:00 pm UTC
1991-01-01T04:30:00
1990-12-31T17:00:00

{{ site.time | date_to_long_string }}
{{ site.time | date_to_long_string: "ordinal" }}
{{ site.time | date_to_long_string: "ordinal", "US" }}

07 November 2008
7th November 2008
November 7th, 2008

{{ site.time | date_to_rfc822 }}

Mon, 07 Nov 2008 13:07:54 -0800

{{ site.time | date_to_string }}
{{ site.time | date_to_string: "ordinal" }}
{{ site.time | date_to_string: "ordinal", "US" }}

07 Nov 2008
07th Nov 2008
Nov 7th, 2008

{{ site.time | date_to_xmlschema }}

2008-11-07T13:07:54-08:00

{{event_timestamp}}

{{ 'now' | date: '%I:%M %p %B %d, %Y' }}
{{ 'now' | date: '%s' | plus: 0 | add_day: 1 | date: '%I:%M %p %B %d, %Y'}}

08:28 AM May 11, 2021
08:28 AM May 12, 2021

{{ <unix_timestamp> | subtract_day: <int_days> }}

{{ 1477430251 | subtract_day: 7 }}

{{ <unix_timestamp> | subtract_month: <int_months> }}

{{ 1477430251 | subtract_month: 2 }}

{{ <unix_timestamp> | subtract_year: <int_years> }}

{{ 1477430251 | subtract_year: 4 }}

{{ "mick, keith, nil, Charlie" | compact }}

mick, keith, Charlie

{% assign stones = "mick, keith, ronnie, charlie" | split: ", " %}
{% assign beatles = "john, paul, george, ringo" | split: ", " %}
{% assign rolling_beatles = stones | concat: beatles %}
{{ rolling_beatles | join: ", " }}

mick, keith, ronnie, charlie, john, paul, george, ringo

{{ customer.purchases | find: "type", "kitchen" | json }}

{"date":"1726589206","title":"utensils","type":"kitchen"}

{{ members | find_exp: "item", "item.graduation_year == 2014" | json }}

{"graduation_year":2014,"name":"John"}

acme.characters = ["Wile E Coyote", "Road Runner"]
{{ acme.characters | first }}

Wile E Coyote

{% assign groups = customer.purchases | group_by: "type" %}

{% for group in groups %}

  {{group.name | capitalize}}

  {% for item in group.items %}

    - {{ item.title }}

  {% endfor %}

{% endfor %}

Bathroom
- shower curtain
- body soap
Kitchen
- forks
- spoons
- knives

{% assign groups = customer.purchases | group_by_exp: "item", "item.type contains 'kitchen'" %} 

{% for group in groups %}

  {% if group.name == true %}

    You bought some kitchen supplies from us in the past year:

      {% for item in group.items %}

      - {{item.title}}

      {% endfor %}

  {% endif %}

{% endfor %}

You bought some kitchen supplies from us in the past year:
- forks
- spoons
- knives

acme.characters = ["Wile E Coyote", "Road Runner"]
{{ acme.characters | join: ', ' }}

Wile E Coyote, Road Runner

{{ customer.arrayOfColorObjects | concat: customer.arrayOfColorObjectsWithDuplicationsAndNew | json_array_uniq: 'name' | to_json }}

[{"color":"brown","name":"coyote"},{"color":"black","name":"bugs"},{"color":"yellow","name":"tweety"},{"color":"black","name":"daffy"}]

acme.characters = ["Wile E Coyote", "Road Runner"]
{{ acme.characters | last }}

Road Runner

{% assign beatles = "john, paul, george, ringo" | split: ", " %}
{{ beatles | limit: 2 | join: ", " }}

john, paul

Array of objects: [{"name":"coyote"},{"name":"bugs"},{"name":"tweety"}]"
{% assign names = customer.characters | map: 'name' %}

coyote, bugs, tweety

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

{% assign everything = fruits | pop %}

{% for item in everything %}
- {{ item }}
{% endfor %}

- apples
- oranges

{% assign fruits = "apples, oranges" | split: ", " %}

{% assign everything = fruits | push: "peaches" %}

{% for item in everything %}
- {{ item }}
{% endfor %}

- apples
- oranges
- peaches

{% assign pl = customer.products | remove: customer.products[0] %}
- {{ customer.products.size }}
- {{ pl.size }}

- 2
- 1

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

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

plums, peaches, oranges, apples

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

{% assign everything = fruits | shift %}

{% for item in everything %}
- {{ item }}
{% endfor %}

- oranges
- peaches

{{ "That's all, folks!" | size }}
{{ customer.latest_purchase | size }}
{{ objects.online_classes | size }}
{{ objects.online_classes.size }}

18 // The number of characters
4 // If `latest_purchase` is an array, this returns the number of items in the array. Otherwise, it returns a count of characters.
2 // The number of objects (onlines classes) that a person is related to.
2 // Using the size filter with dot notation

{% assign beatles = "paul, john, ringo, george" | split: ", " %}

{{ beatles | sort | join: ", " }}

george, john, paul, ringo

{{ "mick, keith, Charlie, Ronnie" | sort_natural }}

Charlie, keith, mick, Ronnie

{% assign nums = '1,2,3' | split: ',' %}
{{ nums | sum }}

{% assign letters = 'a,b,c' | split: ',' %}
{{ letters | sum }}

{{ cart.products | sum: 'total_number' }} {% comment %} where `total_number` includes milk,cheese,eggs {% endcomment %}

{{ purchase.products | sum }} {% comment %} where `products` includes true,false {% endcomment %}

6
0
3
1 {% comment %} counts the number of trues, would also aggregate numbers alongside booleans {% endcomment %}

{% assign my_array = '"lions", "tigers", "bears", "bears", "lions"' %}
{{ my_array | uniq | join: ", " }}

lions, tigers, bears

{% assign fruits = "oranges, peaches" | split: ", " %}

{% assign everything = fruits | unshift: "apples" %}

{% for item in everything %}
- {{ item }}
{% endfor %}

- apples
- oranges
- peaches

All Players:
{% for player in customer.players %}
  - {{ player.last_name }}
{% endfor %}

Baseball Players:
{% assign baseball_players = customer.players | where: "sport", "baseball" %}
{% for player in baseball_players %}
  - {{ player.last_name }}
{% endfor %}

----------------------------

All products:
{% for product in customer.products %}
- {{ product.title }}
{% endfor %}

{% assign available_products = customer.products | where: "available" %}

Available products:
{% for product in available_products %}
- {{ product.title }}
{% endfor %}

All products:
{% for product in customer.products %}
- {{ product.title }}
{% endfor %}

{% assign kitchen_products = customer.products | where_exp: "item", "item.size > 30 and item.type == 'kitchen'" %}

Kitchen products:
{% for product in kitchen_products %}
- {{ product.title }}
{% endfor %}

All players:
{% for player in customer.players %}
  - {{ player.last_name }}
{% endfor %}

Not baseball players:
{% assign not_baseball_players = customer.players | where_not: "sport", "baseball" %}
{% for player in not_baseball_players %}
  - {{ player.last_name }}
{% endfor %}

All players:
  - Posey
  - Maradona
  - Montana
  - Gretzky
  - Jordan

Not baseball players:
  - Maradona
  - Montana
  - Gretzky
  - Jordan

{{ 3.14 | abs }}

3.14

{{ 3.14 | ceil }}

4

{% comment %} no arguments: {% endcomment %}
  {{ 1234567.896 | currency }}
{% comment %} only locale: {% endcomment %}
  {{ 1234567.896 | currency: 'en-GB' }}
{% comment %} locale and currency code: {% endcomment %}
  {{ 1234567.896 | currency: 'en', 'EUR' }}

$1,234,567.90
£1,234,567.90
€1,234,567.90

{{ 3.14 | floor }}

3

{{ 10000 | format_number }}
{{ 123456.78 | format_number: "fr" }}

10,000
123 456,78

{% random 100 %}

{{ 4.32 | round }}
{{ 4.32 | round: 1 }}

4
4.3

{% comment %} no arguments: {% endcomment %}
  {{ 1234567.896 | rounded_currency }}
{% comment %} only locale: {% endcomment %}
  {{ 1234567.896 | rounded_currency: 'en-GB' }}
{% comment %} locale and currency code: {% endcomment %}
  {{ 1234567.896 | rounded_currency: 'en', 'EUR' }}

$1,234,568
£1,234,568
€1,234,568

{{ 41 | at_least: 42 }}

42

{{ 100 | at_most: 99 }}

99

{{ 10 | divided_by: 2.5 }}
{{ 10 | divided_by: 4 }}
{{ 10 | divided_by: 4.0 }}

4
2.5
2.5

{{ 10 | minus: 1 }}

9

{{ 3 | modulo: 2 }}

1

{{ 10 | plus: 1 }}

11

{{ 5 | times: 2 }}
{{ 10 | times: 2.5 }}

10
25

{{ "What's all the hubbub, " | append: "bub?" }}

What's all the hubbub, bub?

{{ customer.groceries | split:"," | array_to_sentence_string }}
{{ customer.groceries | split:"," | array_to_sentence_string: "or" }}

cherry, kiwi, and passion fruit
cherry, kiwi, or passion fruit

{{ 'Hello, world!' | base64 }}

SGVsbG8sIHdvcmxkIQ==

{{ "Zm9vLmJhcg==" | base64_decode }}

foo.bar

{{ "foo.bar" | base64_encode }}

Zm9vLmJhcg==

{{ "Zm9vLmJhcg" | base64_url_safe_decode }}

foo

{{ "foo" | base64_url_safe_encode }}

Zm9vLmJhcg

{{ "hello world" | capitalize }}

Hello world

{{ "overview: account" | cgi_escape }}

overview%3A+account

{% if product.description contains 'lorem ipsum' %}
  You might also be interested in Fillerama or Office Ipsum.
{% endif %}

{{ 'STRING' | downcase }}

{{ "ACME" | downcase }}

acme

{{ "win+help@customer.io" | escape }}

win%2Bhelp%40customer.io

{{ "1 < 2 & 3" | escape_once }}

1 < 2 & 3

{{ "Customer.io" | hmac_sha256: "some_key" | hex_base64 }}

bd23cyOCFrzicxM7w/ahKoJPQd0YTQlFLwXHZZ2ufVc=

{{ "Customer.io" | hmac_sha1: "some_key" }}

2bdf556c9a75766f258d1e2824f6d0e31d1beedc

{{ "Customer.io" | hmac_sha256: "some_key" }}

6dddb773238216bce273133bc3f6a12a824f41dd184d09452f05c7659dae7d57

text{{ " Customer.io " | lstrip }}text

textCustomer.io text

{{ "Customer.io" | md5 }}

d52b6a207bf5255c05b1d0056230617e

<br />
Customer.io<br />
liquid<br />

{{ "a \n b" | normalize_whitespace }}

a b

{{ "Welcome to Customer.io!" | number_of_words }}

3

{{ int-val | pluralize: 'singular', 'plural'}}

{{ event.item_count | pluralize: 'item', 'items' }}

3 items

{{ "Sufferin' succotash!" | prepend: "Sylvester: " }}

Sylvester: Sufferin' succotash!

{{ "folks that's all, folks!" | remove_first: "folks" }}

that's all folks!

{{ "foobarbar" | remove_last: "bar" }}

foobar

{{ "And that's all, folks!" | remove: ", folks" }}

And that's all!

{{ "String you want to replace values in" | replace: "find-str", "replace-str" }}

{{ "Coyotes never catch roadrunners!" | replace: "never", "always" }}

Coyotes always catch roadrunners!

{{ "String you want to replace values in" | replace_first: "find-str", "replace-str" }}

{{ "roller rocket roller skates" | replace_first: "roller", "awesome" }}

awesome rocket roller skates

{{ "foobarbar" | replace_last: "bar", "foo" }}

foobarfoo

text{{ " Customer.io " | rstrip }}text

text Customer.iotext

{{ "Customer.io" | sha1 }}

c197ff0ae0a41983362f35ca972c544061c54d4c

{{ "Customer.io" | sha256 }}

6dddb773238216bce273133bc3f6a12a824f41dd184d09452f05c7659dae7d57

{{ "string" | slice: <req, index of char>, <optional, length of result> }}

{{ "Customer.io" | slice: 3 }}
{{ "Customer.io" | slice: 3, 3 }}
{{ "Customer.io" | slice: '-4', 3 }}

t
tom
r.i

{{ "The _config.yml file" | slugify }}

{{ "The _config.yml file" | slugify: "pretty" }}

{{ "The _cönfig.yml file" | slugify: "ascii" }}

{{ "The cönfig.yml file" | slugify: "latin" }}

{{ "The cönfig.yml file" | slugify: "latin", true }}

the-config-yml-file

the-_config.yml-file

the-c-nfig-yml-file

the-config-yml-file

The-config-yml-file

{% assign rolling_stones = "Mick, Keith, Ronnie, Charlie" | split: ", " %}

{% for member in rolling_stones %}
  {{ member }}
{% endfor %}

text{{ " Customer.io " | strip }}text

Customer.io

{{ "Eh, what's <i>up</i>, <b>Doc</b>?" | strip_html }}

Eh, what's up, Doc?

{{ product.description | strip_newlines }}

{{ 'string' | titlecase }}

{{ "rocket roller skates" | titlecase }}

Rocket Roller Skates

{{ "I knew I shoulda taken that left turn at Albuquerque." | truncate: 20 }}

I knew I shoulda ...

{{ "I knew I shoulda taken that left turn at Albuquerque." | truncatewords: 8 }}

I knew I shoulda taken that left turn...

{{ 'string' | upcase }}

{{ 'acme' | upcase }}

ACME

{{ "https://example.com/?q=foo, \bar?" | uri_escape }}

https://example.com/?q=foo,%20%08ar?

{{ "%27Customer.io+is+great%27" | url_decode }}

Customer.io is great

{{ "cool.person@example.com" | url_encode }}

cool.person%40example.com

{{ "Have you seen \'Learn the basics: video guide\'?" | xml_escape }}

Have you read 'James & the Giant Peach'?

{% comment %} Don't display me! {% endcomment %}

{{ product_color | default: "red" }}
{{ product_price | default: 2.99 }}

{% assign var = '{"key": "value", "number": 123, "boolean": true}' | from_json %}
{{ var.key }}
{{ var.number }}
{{ var.boolean }}

{% assign fruit = '{"type": "kiwi", "quantity": 2, "sweet": true}' | from_json %}
{{ fruit.type }}
{{ fruit.quantity }}
{{ fruit.sweet }}

{% assign greeting = '[{"greeting": "hello" }, {"greeting": "hey" }, {"greeting": "hi" }, {"greeting": "howdy" }]' | from_json %}
{{ intro[0].greeting }}
{{ intro[1].greeting }}
{{ intro[2].greeting }}
{{ intro[3].greeting }}

kiwi
2
true

hello
hey
hi
howdy

{% generate_uuid %}

{% assign arr = "foo bar coo" | split: " " %}
{{ arr | json: 4 }}

[
  "foo",
  "bar",
  "coo"
]

{% raw %}
  {{This}} is displayed exactly as typed.
{% endraw %}

{{ customer | to_json }}

{% assign username = "Charlie" %}
Hello, {{ username -}} !

Hello, Charlie!