Variant products and how to set them up

News, Emails and Webinars, Manual Input, Heureka XML Feed, MALL XML Feed, API

This article will show you all the information on how to properly set up variants for your products for each connection.


Basic information

To display your products correctly on the 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.
We recommend to have a maximum of 200 variants per product, the database limit is 300 per product. Variants uploaded above this number will not be displayed on our website.

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, such as size and color, to create a variant product.

MALL does not store data about your products, if they are deleted, product recovery is not possible.

In case you have any further questions, you can contact us via Help Centre.

Back to top

Manual connection

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, e.g. color, where you can specify multiple colors in the Parameters tab.

After adding the variant parameters, you will see in the Variants generates a list of variants, 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 on 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 "pipe" symbol.

Then you just need to save the product when editing or continue filling 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.

In case you have any further questions, you can contact us via Help Centre.

Back to top

Heureka XML Feed

Variants are not created automatically within the Heureka feed. To create a variant product, it is necessary to have variant products marked with the element in the Heureka XML product feed ITEMGROUP_ID and also send a variant parameter in the element PARAM.

  • 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 - For variant products the 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 icon "Variant product". You 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. Automatic matching of parameters and values from the feed is not possible. If you offer variant products in many categories, we recommend you also study other types of connections or services from one of our providers supplements.

Then you have to load the feeds manually on the Feed Settings tab:

In case you have any further questions, you can contact us via Help Centre.

Back to top


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 prerequisite 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.

Sample of a variant product with all details in XML feed

Back to top

API connection

variant products first use the method Create new product to create the main product. Then into this product using the method Create new variant 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.

In case you have any further questions, you can contact us via Help Centre.

Back to top

How useful was this post?

Click on the star to rate the post!

Average rating: 1.5 / 5. Number of votes: 10

No one has voted yet. Be the first to rate this post.