Correctly configuring your item groups is essential for ensuring products sync properly and are displayed correctly within Intercom. This guide explains how to set the group attribute on the Admin > Items > Detail tab.
How do I set the group attribute for my items? 🤔
The setting for the group attribute depends on whether the item is sold by itself (standalone) or as part of a group of variations (e.g., different sizes or colors).
Standalone (Orphan) Items
A standalone or "orphan" item is a product that is not part of a larger group. It's a single item without variations like size or color.
Rule: For any standalone item, you must set the
groupattribute to "variant".
This tells the system that although it's technically a "variant," it stands on its own and is not a child of another parent item.
Example: You sell a specific book. It has no variations.
Item: The Great Gatsby book
Setting: On the
Admin > Items > Detailtab, setgroup= variant.
Grouped Items (Parent-Child)
A grouped item consists of a main "parent" product and several "child" variations. This is common for products like apparel that come in multiple sizes and colors.
Parent Item
The parent item acts as a container for all the variations. It is not a sellable item itself but holds the general product information.
Rule: For the main parent item, set the
groupattribute to "parent".
Child Items (Variants)
The child items are the actual, specific variations of the product that a customer can buy (e.g., a small, red t-shirt).
Rule: For all child items, set the
groupattribute to "variant".Assignment: You must then assign these child items to the correct parent item.
Example: You sell a T-shirt that comes in two sizes (Small, Medium) and two colors (Red, Blue).
Create a Parent Item: "Company Logo T-Shirt"
On its
Admin > Items > Detailtab, setgroup= parent.
Create Child Items (Variants):
"Company Logo T-Shirt - Small, Red"
"Company Logo T-Shirt - Medium, Red"
"Company Logo T-Shirt - Small, Blue"
"Company Logo T-Shirt - Medium, Blue"
Configure Child Items:
For each of the four child items, set
group= variant.Assign all four child items to the "Company Logo T-Shirt" parent item.