Skip to Content
ReferenceLiquid ReferenceFiltersArray

Array Filters

These filters are used to manipulate arrays in Liquid templates. They allow you to combine, filter, transform, and extract data from arrays, making it easier to work with collections of items. Use these filters to clean up arrays, join or split values, find specific elements, and modify image URLs within arrays.

compact

Removes blank (false, null, ”) values from the array.

Input

{% assign my_bugs = "ants, bees, ," | split: ", " | compact %} {{ my_bugs | join: ", " }}

Output

ants, bees

concat

Combines an array with another array. The resulting array will contain all the elements from both arrays. Duplicates will not be removed (that can be done with uniq filter).

Input

{% assign my_bugs = "ants, bees, spiders" | split: ", " %} {% assign my_other_bugs = "wasps" | split: ", " %} {% assign all_bugs = my_bugs | concat: my_other_bugs %} {{ all_bugs | join: ", " }}

Output

ants, bees, spiders, wasps

find

Returns the value of first matching key

Input

All products: {% for product in products %} - {{ product.title }} {% endfor %} First match: {{ first_product = products | find: "type", "kitchen" }}

Output

All products: - Vacuum - Spatula - Television - Garlic press First match: - Spatula

first

Returns the first element of an array.

Input

{{ "The quick brown fox jumps over the lazy dog" | split: " " | first }}

Output

The

img_modify

Modifies the image URL. Supported modifications are: width, height, quality, dpr, resize-type, format, min-width, min-height.

Input

{{ product.image | img_modify: 'width', 200 }} {{ product.image | img_modify: 'height', 200 }} {{ product.image | img_modify: 'quality', 80 }} {{ product.image | img_modify: 'dpr', 2 }} {{ product.image | img_modify: 'resize-type', 'fit' }} {{ product.image | img_modify: 'format', 'webp' }} {{ product.image | img_modify: 'min-width', 200 }} {{ product.image | img_modify: 'min-height', 200 }}

Output

https://images.finqu.com/yw9wqO60K99y8VNVDipxjpT5au7ghr/some-image.jpg?w=200 https://images.finqu.com/yw9wqO60K99y8VNVDipxjpT5au7ghr/some-image.jpg?h=200 https://images.finqu.com/yw9wqO60K99y8VNVDipxjpT5au7ghr/some-image.jpg?q=80 https://images.finqu.com/yw9wqO60K99y8VNVDipxjpT5au7ghr/some-image.jpg?dpr=2 https://images.finqu.com/yw9wqO60K99y8VNVDipxjpT5au7ghr/some-image.jpg?rt=fit https://images.finqu.com/yw9wqO60K99y8VNVDipxjpT5au7ghr/some-image.jpg?ext=webp https://images.finqu.com/yw9wqO60K99y8VNVDipxjpT5au7ghr/some-image.jpg?mw=200 https://images.finqu.com/yw9wqO60K99y8VNVDipxjpT5au7ghr/some-image.jpg?mh=200

join

Joins elements of an array with a given character between them.

Input

{{ "The, quick, brown, fox, jumps, over, the, lazy, dog" | split ", " | join " " }}

Output

The quick brown fox jumps over the lazy dog

lst

Returns the last element of an array.

Input

{{ "The quick brown fox jumps over the lazy dog" | split: " " | last }}

Output

dog

map

Collect a given property from and array of objects

Input

{% assign product_names = category.products | map: 'name' %} {% for name in product_names %} * {{ name }} {% endfor %}

Output

* Skateboard * Beenie * Jeans

pop

Removes the last element from an array.

Input

{% assign my_bugs = "ants, bees, spiders" | split: ", " %} {% assign last_bug = my_bugs | pop %} {{ last_bug }}

Output

spiders

push

Adds an element to the end of an array.

Input

{% assign my_bugs = "ants, bees, spiders" | split: ", " %} {% assign my_other_bugs = "wasps" | split: ", " %} {% assign all_bugs = my_bugs | push: my_other_bugs %} {{ all_bugs | join: ", " }}

Output

ants, bees, spiders, wasps

random

Return a random element from the array.

Input

{% assign my_bugs = "ants, bees, flies" | split: ", " %} {{ my_bugs | random }} {{ my_bugs | random }} {{ my_bugs | random }}

Output

bees flies bees

reverse

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

Input

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

Output

plums, peaches, oranges, apples

shift

Removes the first element from an array.

Input

{% assign my_bugs = "ants, bees, spiders" | split: ", " %} {% assign first_bug = my_bugs | shift %} {{ first_bug }}

Output

ants

size

Returns the number of characters in a string or the number of items in an array.

Input

{{ "The quick brown fox jumps over the lazy dog" | size }} {{ "The quick brown fox jumps over the lazy dog" | split: " " | size }}

Output

43 9

slice

Returns a substring of one character or series of array items beginning at the index specified by the first argument. An optional second argument specifies the length of the substring or number of array items to be returned.

Input

{{ "Liquid" | slice: 0 }} {{ "Liquid" | slice: 2, 5 }} {{ "The quick brown fox jumps over the lazy dog" | split: " " | slice: 1,2 | join: " " }}

Output

L quid quick brown

sort

Sort the elements of an array. An optional argument specifies which property of the array’s items to use for sorting.

Input

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

Output

Sally Snake, giraffe, octopus, zebra

uniq

Remove duplicate elements from an array.

Input

{% assign my_array = "ants, bugs, bees, bugs, ants" | split: ", " %} {{ my_array | uniq | join: ", " }}

Output

ants, bugs, bees

unshift

Adds an element to the beginning of an array.

Input

{% assign my_bugs = "ants, bees, spiders" | split: ", " %} {% assign my_other_bugs = "wasps" | split: ", " %} {% assign all_bugs = my_bugs | unshift: my_other_bugs %} {{ all_bugs | join: ", " }}

Output

wasps, ants, bees, spiders

where

Creates an array including only the objects with a given property value, or any truthy value by default.

In this example, assume you have a list of products and you want to show your kitchen products separately. Using where, you can create an array containing only the products that have a “type” of “kitchen”.

Input

All products: {% for product in products %} - {{ product.title }} {% endfor %} {% assign kitchen_products = products | where: "type", "kitchen" %} Kitchen products: {% for product in kitchen_products %} - {{ product.title }} {% endfor %}

Output

All products: - Vacuum - Spatula - Television - Garlic press Kitchen products: - Spatula - Garlic press
Last updated on