Added in: v8.1.0
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: |
Output
All products: |
Say instead you have a list of products and you only want to show those that are available to buy. You can where
with a property name but no target value to include all products with a truthy "available"
value.
Input
All products: |
Output
All products: |
The where
filter can also be used to find a single object in an array when combined with the first
filter. For example, say you want to show off the shirt in your new fall collection.
Input
{% assign new_shirt = products | where: "type", "shirt" | first %} |
Output
Featured product: Hawaiian print sweater vest |