Skip to main content Link Search Menu Expand Document (external link)

Liquid Filters

Standard Filters

abs

Returns an absolute value of a number e.g.

 {{ -17 | abs }} }} #=> 17

append

append a string e.g.

 {{ 'foo' | append:'bar' }} #=> 'foobar'

capitalize

capitalize words in the input sentence

ceil

rounds a number up to the nearest integer, e.g.

 {{ 4.6 | ceil }} #=> 5

date

reformat a date (syntax reference)

default

returns the given variable unless it is null or the empty string, when it will return the given value, e.g.

 {{ undefined_variable | default: "Default value" }} #=> "Default value"
 {{ product_price | default: 2.99 }} #=> 2.99
 {% assign product_price = 4.99 %}
 {{ product_price | default: 4.99 }}  #=> 4.99

divided_by

integer division e.g.

 {{ 10 | divided_by:3 }} #=> 3

downcase

convert an input string to lowercase

escape_once

returns an escaped version of html without affecting existing escaped entities

escape

html escape a string

first

get the first element of the passed in array

floor

rounds a number down to the nearest integer, e.g.

 {{ 4.6 | floor }} #=> 4

join

join elements of the array with certain character between them

last

get the last element of the passed in array

lstrip

strips all whitespace from the beginning of a string

map

map/collect an array on a given property

minus

subtraction e.g.

 {{ 4 | minus:2 }} #=> 2

modulo

remainder, e.g.

 {{ 3 | modulo:2 }} #=> 1

newline_to_br

replace each newline (\n) with html break

plus

addition e.g.

 {{ '10' | plus:'1' }} #=> 11

prepend

prepend a string e.g.

 {{ 'bar' | prepend:'foo' }} #=> 'foobar'

remove_first

remove the first occurrence e.g.

 {{ 'barbar' | remove_first:'bar' }} #=> 'bar'

remove

remove each occurrence e.g.

 {{ 'foobarfoobar' | remove:'foo' }} #=> 'barbar'

replace_first

replace the first occurrence e.g.

 {{ 'barbar' | replace_first:'bar','foo' }} #=> 'foobar'

replace

replace each occurrence e.g.

 {{ 'foofoo' | replace:'foo','bar' }} #=> 'barbar'

reverse

reverses the passed in array

round

rounds input to the nearest integer or specified number of decimals e.g.

 {{ 4.5612 | round: 2 }} #=> 4.56

rstrip

strips all whitespace from the end of a string

size

return the size of an array or string

slice

slice a string. Takes an offset and length, e.g.

 {{ "hello" | slice: -3, 3 }} #=> llo

sort

sort elements of the array

split

split a string on a matching pattern e.g.

 {{ "a~b~c" | split:"~" }} #=> ['a','b', 'c']
{% assign beatles = "Usage, Adoption, Retention, Renewal, Revenue Expansion" | split: ", " %}
    {% for member in beatles %}
    {{ member }}
{% endfor %}
#=>
Usage

Adoption

Retention

Renewal

Revenue Expansion

strip_html

strip html from string

strip_newlines

strip all newlines (\n) from string

strip

strips all whitespace from both ends of the string

times

multiplication e.g

 {{ 5 | times:4 }} #=> 20

truncate

truncate a string down to x characters. It also accepts a second parameter that will append to the string e.g.

 {{ 'foobarfoobar' | truncate: 5, '.' }} #=> 'foob.'

truncatewords

truncate a string down to x words

uniq

removed duplicate elements from an array, optionally using a given property to test for uniqueness

upcase

convert an input string to uppercase

url_encode

url encode a string