This article will give you all the information on how to properly set up variants for your products for each connection type.
To display your products correctly on our page, you need to pay attention to the possibility of creating groups of variant products. For products that consist of more than 4 variants it is mandatory to create variant products.
By creating variant products, you can improve their display on the website and the clarity of the entire category for the customer. This will increase the marketability of your products.
The product variants are displayed in the product detail as one product card with the option to select e.g. size or colour.
For all connections, the rule is that you can use a maximum of 2 parameters, for example size and colour, to create a variant product.
MALL does not store data about your products, if they are deleted, product recovery is not possible.
How to create variants when creating new products can also be found in the article Instructions for Manual connection - the process of creating a new product.
You can create variants for a product by checking the "Variable parameter" box, for example color, where you can specify multiple colors in the Parameters tab.
After adding the variant parameters, a list of variants will be generated in the Variants tab, where it is necessary to modify the necessary data for each variant.
Here you need to fill in the ID of each variant, its stock availability and the number of days needed for delivery.
Subsequent changes must be made only in the Variants tab, not on the Basic or Parameters tab. Edits made in these tabs are not automatically overwritten in the Variants tab.
WARNING: Any changes made after the variant generation on the variant parameter in the Parameters section will cause new variants to be created. Previous variants will be deleted.
To open the variant detail, use the "down arrow" to fill in the missing data for the variant.
It is necessary to mark the main image of the variant using the "star" button and at the same time mark other images of the variant using the "tick" symbol.
Then you just need to save the product when editing or continue to fill in other specifications when creating the product.
Additional editing or adding photos must be done for each of the variants separately. Photos uploaded to the Basic tab after creating variants are not overwritten for each variant.
Heureka XML Feed
Variants are not created automatically within the Heureka feed. To create a variant product, it is necessary to have variant products in the Heureka XML product feed marked with the ITEMGROUP_ID element and also to send the variant parameter in the PARAM element.
- ITEMGROUP_ID - Mandatory element necessary for variants, on the basis of which our system recognizes the variant product. It must not be the same as ITEM_ID and must be unique.
Combination of maximum 36 characters, allowed characters are: _ - 0-9 a-z A-Z (underscores, hyphens, numbers zero to nine, upper and lower case letters without diacritics).
- PARAM - Optional element that can be subsequently paired to our parameters in the portal. In case of creating a variant product, this element is mandatory.
To create a variant product, you need to pair the variant parameters in the MALL Partner portal (in the Heureka feed - Pairing parameters tab), all values of the parameter and then check the "Variant product" icon. This will confirm to the system that you want to create variant products based on the selected parameter.
The parameter selected for creating variants must be based on the parameter code available for the category on the MALL page. Values can only be matched to values from our predefined values for the parameter. Numerical parameters do not need to be further manually matched.
Available parameters and exact values for each category can be found in Category in the Partner Portal, for instructions on how to work with this section please see here.
A maximum of 2 variant parameters can be marked per category.
The pairing of parameters and values must be done separately for each category. Any form of import is not possible. If you offer variant products in many categories, we recommend you consider other types of connections or services from one of our plug-in providers.
Then you have to load the feeds manually on the Feed Settings tab:
MALL XML Feed
Each variant has in product feed a separate entry and is identified by 3 mandatory elements that are key to creating a variant product.
- ITEMGROUP_ID - The element indicates the ID of the variant group. The ITEMGROUP_ID shall always be unique and shall not be identical to the ITEM_ID or any other ITEMGROUP_ID group.
Combination of maximum 50 characters, allowed characters are: _ - 0-9 a-z A-Z (underscores, hyphens, numbers zero to nine, upper and lower case letters without diacritics).
- ITEMGROUP_TITLE - This field indicates the title of the parent product. Do not fill in the specifications of individual variants here (e.g. black, XL, etc.). This is the general name of the variant group.
- VARIABLE_PARAMS - Indicates variable parameters (MAX 2). The condition for using the VARIABLE_PARAMS element is sending the necessary parameters and values in the PARAM section.
Here you can download a sample product feed in .xml format - Variant product with all elements.
The example of a variant product with all the essentials in XML feed
For variant products first use the Create new product method to create the main product. Then add variants to this product using the Create a new variant to add variations.
Variants need to be distinguished using variant parameters. It is possible to use up to two of the parameters available in a given category.
The variants assigned to the main product are then always displayed on the product detail with the corresponding parameter as an optional variable by the customer.
For more information, see our API documentation here.