Match Variants (Color & Size)
Many shops work with variant products – for example, a T-shirt in several colors and sizes. In Shopware, a parent product forms the common bracket, while the individual variants (child products) represent the specific attribute values. The connector supports this model and can assign existing variants to the BC items.
The variant model
The parent item (kept in BC as the "Parent Item") can be created automatically during matching.
The associated child items are linked to the parent.
The variant axes are mapped as option 1, option 2, and option 3 – typically color and size.
Configuring the color and size property
So that the connector knows which property group represents the color axis and the size axis, enter this in the Shopware configuration:
Color attribute label
Name of the color property in Shopware (default: "Color").
Size attribute label
Name of the size property in Shopware (default: "Size").
Color attribute ID
Technical ID of the color property group.
Size attribute ID
Technical ID of the size property group.
Default attribute set
The attribute set that is used for variants.
Use model as configurable
Controls whether the model is treated as a configurable (variant) product.
The labels must match the actual property group names in the shop. The IDs refer to the specific property group and are used for unique assignment.
Prerequisite: match the attributes first
Variants only work if the underlying property groups (color, size) and their options are linked correctly. Therefore, run the attribute matching first – see Match Attributes & Properties (Property Groups).
Step by step
Configure the properties
Enter the label and ID for color and size as well as the default attribute set in the configuration.
Match the attributes
Link the property groups and option values.
Match the products
Run the product matching. Parent items are created, and child items are linked including option 1/2/3.
Check the result
On the parent item, check whether the variants are assigned correctly.
Troubleshooting
The variant is not recognized
The color or size label or ID is incorrect. Check the configuration.
Option is missing
The option value was not matched – link the attributes and options first.
Parent is missing
Check whether "Use model as configurable" is enabled.
Frequently Asked Questions
How are variants linked to their main item?
The link is created through the "SOUSHW Parent No" field, which refers to the parent item (SOUSHW Parent Item). The variant-forming characteristics such as color and size are transferred as property groups (attributes) and used in Shopware as variant axes.