# ProductComponent - Liquid Object Reference

Source: https://support.storeconnect.com/articles/product-component-liquid-object-reference · Last modified 21 August 2026

## Description

The ProductComponent object represents a component that can be included in a New Product Bundle.
      It defines the relationship between an anchor product and a component product with quantity rules and pricing.

:::note
This object supports custom data via the `data` attribute.
:::

## Attributes

| Attribute | Type | Description |
|-----------|------|-------------|
| `anchor_product` | [Product](product-liquid-object-reference) | Returns the anchor Product for this component |
| `can_edit_quantity?` | Boolean | Returns true if this component can have addable quantity |
| `chargeable_quantity` | Number | Returns the quantity that will be charged (accounting for free quantity) |
| `component_pricing` | [ComponentPricing](component-pricing-liquid-object-reference) | Returns special bundle pricing for this component |
| `component_product` | [Product](product-liquid-object-reference) | Returns the component Product |
| `component_unit_price` | Number | Returns the effective bundle price (Used for JS to reference the added price on the bundle) |
| `default_quantity` | Number | Returns the default quantity for this component |
| `free_quantity` | Number | Returns the quantity included free in bundle price |
| `group` | [ComponentGroup](component-group-liquid-object-reference) | Returns the ComponentGroup this component belongs to |
| `has_component_pricing?` | Boolean | Returns true if this component has special New Product Bundle pricing |
| `has_free_quantity?` | Boolean | Returns true if this component has free quantity included |
| `id` | String | Returns the unique id of this ProductComponent |
| `in_group?` | Boolean | Returns true if this component belongs to a ComponentGroup |
| `included_by_default?` | Boolean | Returns true if this component is included and cannot be removed |
| `max_quantity` | Number | Returns the maximum quantity allowed for this component |
| `min_quantity` | Number | Returns the minimum quantity required for this component |
| `optional?` | Boolean | Returns true if this component is optional in the bundle |
| `position` | Number | Returns the display order position of this component |
| `quantity_range` | String | Returns the valid quantity range for this component |
| `required?` | Boolean | Returns true if this component is required in the bundle |

## Available on

- [ComponentGroup - Liquid Object Reference](component-group-liquid-object-reference) — `components`
- [Product - Liquid Object Reference](product-liquid-object-reference) — `product_components`

---

## Follow StoreConnect

- [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://getstoreconnect.com/partners)
- [News](https://getstoreconnect.com/articles/news)
- [Events](https://getstoreconnect.com/articles/events)
- [Feature Comparison](https://getstoreconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://getstoreconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

---

StoreConnect Support — https://support.storeconnect.com/articles/product-component-liquid-object-reference