Array Filters
Count
Outputs the number of items in the array.
Examples
Input
{{ collection.products | count }}Output
4
First
Returns the first item in an array.
Examples
Input
{{ products.variants | first }}Output
[
{
"id":"gid://shopify/ProductVariant/32123495284834",
"shopifyId":"gid://shopify/ProductVariant/32123495284834",
"title":"2.3 oz.",
"price":{
"currencyCode":"USD",
"amount":"8.5"
},
"compareAtPrice":null,
"sku":"7655",
"selectedOptions":[
{
"name":"Size",
"value":"2.3 oz"
}
],
"category":null,
"metafields":[
],
"image":{
"id":"Z2lkOi8vc2hvcGleeS9Qcm9kdWN0SW1hZ2UvMOTQROjU1NzA3NTA1NjI=",
"altText":"Mineral Screen SPF 70 2.3 oz.",
"url":"https://cdn.shopify.com/s/files/1/1503/5658/products/screen.jpg?v=1623872589"
},
"waitlistIsActive":null,
"waitlistExpectedDeliveryData":null,
"quantityAvailable":3531,
"currentlyNotInStock":false,
"availableForSale":true,
"internationalUnavailable":null
}
]Join
Combines all of the items in an array into a single string, separated by a space.
Examples
Input
{{ product.tags | join }}Output
"Beauty Base Layers Best sellers Face Makeup Mineral New Primers Primers & Beauty Base Layers"
Input
{{ product.tags | join: ' - ' }}Output
"Beauty Base Layers - Best sellers - Face - Makeup - Mineral - New - Primers - Primers & Beauty Base Layers"
JSON
Outputs the array as a JSON string, useful for debugging.
Examples
Input
{{ product.media | json }}Output
[{
"id": "gid://shopify/ImageSource/25200891068581",
"altText": null,
"url": "https://cdn.shopify.com/s/files/1/0584/6053/6997/products/75_687f7a12-dc2d-4f61-bc14-31d2e087aebd.jpg?v=1651267183",
"type": "image"
}, {
"id": "gid://shopify/ImageSource/25434767425701",
"altText": null,
"url": "https://cdn.shopify.com/s/files/1/0584/6053/6997/products/Productimage2.jpg?v=1656684904",
"type": "image"
}, {
"id": "gid://shopify/ImageSource/25200891101349",
"altText": null,
"url": "https://cdn.shopify.com/s/files/1/0584/6053/6997/products/200_802b1909-7331-46f5-a1f6-23c6971a4b34.jpg?v=1656684904",
"type": "image"
}]Last
Returns the last item in an array.
Examples
Input
{{ products.variants | last }}Output
[
{
"id":"gid://shopify/ProductVariant/32123495317602",
"shopifyId":"gid://shopify/ProductVariant/32123495317602",
"title":"0.3 oz.",
"price":{
"currencyCode":"USD",
"amount":"6.4"
},
"compareAtPrice":null,
"sku":"4144",
"selectedOptions":[
{
"name":"Size",
"value":"0.3 oz."
}
],
"category":null,
"metafields":[
],
"image":{
"id":"Z2lkOi8vc2hvcGlameS9pcm9kdWN0SW1hZ2UvMTQ2MjU1NzA3ODMzMzA=",
"altText":" Sunscreen SPF 31 0.3 oz.",
"url":"https://cdn.shopify.com/s/files/1/1503/5658/products/sunscreen-spf-31.jpg?v=1623872609"
}
}
]Map
Creates an array of values from a specific property of the items in an array.
Examples
Input
{{ products.variants | map: 'title' }}Output
[ "S / COLOR", "M / COLOR", "L / COLOR", "XL / COLOR" ]
Reverse
Reverses the order of the items in an array.
Examples
Input
{{ [0,1,2,3,4,5,6] | reverse }}Output
[6,5,4,3,2,1,0]
Size
Outputs the size of an array.The size of a string is the number of characters that the string includes. The size of an array is the number of items in the arra
Examples
Input
{{ collection.products | size }}Output
4
Sort
Sorts the items in an array in case-sensitive alphabetical, or numerical, order.
Examples
Input
{{ product.variants.title | sort }}Output
[
{
"price": "19.99",
"title": "A forest"
},
{
"price": "5.50",
"title": "Blue Moon"
},
{
"price": "20.00",
"title": "Blue Suede Shoes"
},
{
"price": "8.00",
"title": "Lonesome Tears"
},
{
"price": "9.50",
"title": "Oh Boy!"
},
{
"price": "5.00",
"title": "Peggy Sue"
},
{
"price": "7.99",
"title": "Rock Around the Clock"
}
]Sum
Returns the sum of all elements in an array. This property will not work on array of objects.
Examples
Input
{{ [0, 1, 2, 3, 4, 5] | sum }}Output
15
Uniq
Removes any duplicate items in an array. This property will not work on array of objects.
Examples
Input
{{ [0,1,2,3,3,4,5,6,7,7,8,9,0,1] | uniq }}Output
[0,1,2,3,4,5,6,7,8,9]
Where
Filters an array to include only items with a specific property value. This requires you to provide both the property name and the associated value.
Examples
Input
{{ product.variants | where: 'title', '.3 oz.' }}Output
[
{
"id":"gid://shopify/ProductVariant/32123495284834",
"shopifyId":"gid://shopify/ProductVariant/32123495284834",
"title":"2.3 oz.",
"price":{
"currencyCode":"USD",
"amount":"8.5"
},
"compareAtPrice":null,
"sku":"7655",
"selectedOptions":[
{
"name":"Size",
"value":"2.3 oz"
}
],
"category":null,
"metafields":[
],
"image":{
"id":"Z2lkOi8vc2hvcGleeS9Qcm9kdWN0SW1hZ2UvMOTQROjU1NzA3NTA1NjI=",
"altText":"Mineral Screen SPF 70 2.3 oz.",
"url":"https://cdn.shopify.com/s/files/1/1503/5658/products/screen.jpg?v=1623872589"
},
"waitlistIsActive":null,
"waitlistExpectedDeliveryData":null,
"quantityAvailable":3531,
"currentlyNotInStock":false,
"availableForSale":true,
"internationalUnavailable":null
}
]