{"title":"ComponentGroup - Liquid Object Reference","slug":"component-group-liquid-object-reference","url":"https://support.storeconnect.com/articles/component-group-liquid-object-reference","url_markdown":"https://support.storeconnect.com/articles/component-group-liquid-object-reference.md","subtitle":null,"summary":"The ComponentGroup object represents a group of related components in a New Product Bundle.\n      Component groups define constraints such as minimum and maximum number of components that can be selected.","type":"Developer_Documentation","video_url":"","keywords":"liquid, objects, ComponentGroup, template, storeconnect","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"## Description\n\nThe ComponentGroup object represents a group of related components in a New Product Bundle.\n      Component groups define constraints such as minimum and maximum number of components that can be selected.\n\n:::note\nThis object supports custom data via the `data` attribute.\n:::\n\n## Attributes\n\n| Attribute | Type | Description |\n|-----------|------|-------------|\n| `components` | List[[ProductComponent](product-component-liquid-object-reference)] | Returns the ProductComponents in this group |\n| `display_name` | String | Returns the customer-facing display name of this ComponentGroup |\n| `id` | String | Returns the unique id of this ComponentGroup |\n| `max_components` | Number | Returns the maximum number of different components allowed in this group |\n| `max_group_quantity` | Number | Returns the maximum total quantity across all components in this group |\n| `min_components` | Number | Returns the minimum number of different components required in this group |\n| `min_group_quantity` | Number | Returns the minimum total quantity across all components in this group |\n| `name` | String | Returns the internal name of this ComponentGroup |\n| `optional?` | Boolean | Returns true if this ComponentGroup is optional |\n| `position` | Number | Returns the display order position of this ComponentGroup |\n| `required?` | Boolean | Returns true if this ComponentGroup is required to have selections |\n| `single_choice?` | Boolean | Returns true if this ComponentGroup allows only one component selection |\n\n## Available on\n\n- [Product - Liquid Object Reference](product-liquid-object-reference) — `optional_component_groups`, `required_component_groups`\n- [ProductComponent - Liquid Object Reference](product-component-liquid-object-reference) — `group`"}