{"title":"group_by - Liquid Filter Reference","slug":"group-by-filter-reference","url":"https://support.storeconnect.com/articles/group-by-filter-reference","url_markdown":"https://support.storeconnect.com/articles/group-by-filter-reference.md","subtitle":null,"summary":"Organizes a list of objects into groups based on a shared property value. Each group contains a name and its matching items for easy iteration.","type":"Developer_Documentation","video_url":"","keywords":"liquid, filters, group_by, collections, storeconnect","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Description\n\nGroups an list of objects by a given property\n\n| Property | Value |\n|----------|-------|\n| **Return Type** | list |\n| **Category** | collections |\n\n## Examples\n\n\n```liquid\n\n{% assign list = products | group_by: \"type\" %}\n{% for group in list %}({{ group.name }}){% for item in group.items %}[{{ item.name }}]{% endfor %}{% endfor %}\n```\n\n\n**Output:** `(whitegoods)[Fridgetastic 3000][Coldinator 500](computers)[Geronimo 9000][Y2K Amaze]`\n\n\n```liquid\n\n{% assign list = products | group_by: grouping_field %}\n{% for group in list %}({{ group.name }}){% for item in group.items %}[{{ item.name }}]{% endfor %}{% endfor %}\n```\n\n\n**Output:** `(whitegoods)[Fridgetastic 3000][Coldinator 500](computers)[Geronimo 9000][Y2K Amaze]`"}