{"title":"match - Liquid Filter Reference","slug":"match-filter-reference","url":"https://support.storeconnect.com/articles/match-filter-reference","url_markdown":"https://support.storeconnect.com/articles/match-filter-reference.md","subtitle":null,"summary":"Filters a list or string using a regular expression, returning only the items or characters that match the pattern. Supports capture groups.","type":"Developer_Documentation","video_url":"","keywords":"liquid, filters, match, general, storeconnect","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Description\n\nReturns the items in the list, or characters in the string that match the supplied regex\n\n| Property | Value |\n|----------|-------|\n| **Return Type** | list |\n| **Category** | general |\n\n## Examples\n\n\n```liquid\n\n{{ fruits | match: \"/a/\" | join: \", \" }}\n```\n\n\n**Output:** `apple, banana, date`\n\n\n```liquid\n\n{{ fruits | match: \"/^[ad]/\" | join: \", \" }}\n```\n\n\n**Output:** `apple, date`\n\n\n```liquid\n\n{{ \"metamorphosis\" | match: \"/amo.*sis/\" }}\n```\n\n\n**Output:** `amorphosis`\n\n\n```liquid\n\n{{ \"amorphosis\" | match: \"/(a)(m)(o)/\" | join: \", \" }}\n```\n\n\n**Output:** `amo, a, m, o`"}