{"title":"where - Liquid Filter Reference","slug":"where-filter-reference","url":"https://support.storeconnect.com/articles/where-filter-reference","url_markdown":"https://support.storeconnect.com/articles/where-filter-reference.md","subtitle":null,"summary":"Filters a list to include only objects with a matching property value, or any truthy value when no target is specified. Use `where` to narrow collections by category, status, or type.","type":"Developer_Documentation","video_url":"","keywords":"liquid, filters, where, lists, storeconnect","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Description\n\nCreates an list including only the objects with a given property value, or any truthy value by default.\n\n| Property | Value |\n|----------|-------|\n| **Return Type** | list |\n| **Category** | lists |\n\n## Examples\n\nIn this example, assume you have a list of pages and you want to show your help pages separately. Using `where`, you can create an list containing only the pages that have a \\\n\n\n```liquid\n\n %}\n\nHelp articles:\n{% for article in help_articles -%}\n- {{ article.title }}\n{% endfor %}\n```\n\n\n**Output:** `All articles:\\n- Support\\n- Stock News\\n- FAQs\\n- About Us\\n- Troubleshooting\\n- Setup Guide\\n\\n\\nHelp articles:\\n- Support\\n- FAQs\\n- Troubleshooting\\n- Setup Guide`\n\nSay instead you have a list of articles and you only want to show those that are published. You can use `where` with a property name but no target value to include all articles with a truthy \\\n\n\n```liquid\n\n %}\n\nPublished articles:\n{% for article in published_articles -%}\n- {{ article.title }}\n{% endfor %}\n```\n\n\n**Output:** `All articles:\\n- Support\\n- Stock News\\n- FAQs\\n- About Us\\n- Troubleshooting\\n- Setup Guide\\n\\n\\nPublished articles:\\n- Support\\n- FAQs`"}