The brand is one of the basic mandatory elements for adding products to all language versions of our website. Their viewing and usage varies according to your connection type.
When listing products, the goal is to assign a specific brand to each individual product. By providing brand information, the brand name is automatically written in the beginning of the product title.
Important:Because we have the feature of auto-completing the brand from the Brand field, the brand name must not be part of the product name. Otherwise, the brand name will be duplicated in the title.
The database of established brands is constantly growing based on your requests.
You can search for a brand directly in the MALL Partner Portal or by using API endpoints as shown bellow.
Searching for brands in the MALL Partner portal
Brands can be found in the "Products" section in the "Brands" subsection.
If your brand is listed in our database, just enter the name in the appropriate box. If the brand exists in our database, the uploaded description and logo will be displayed. Otherwise, click on the Request for a new brand button. See instructions bellow.
Among the available information you will find:
- Logo - Brand logo displayed on the product detail (max size 2 MB).
- Brand ID - The technical code of the brand, not containing special characters and spaces. For the MALL feed and API connection types, it is mandatory to use the Brand ID of each brand when creating and updating products.
- Web Title - Text that will be displayed on the web based on the paired brand or the specified Brand ID.
- Brand description - The text that appears in the header of the brand page when it is displayed on the site. The brand description is not visible in the product detail.
Searching for a brand with API
A list of all brands is available via API calls GET_BRANDS.
The list of brands is identical for all countries.
If the brand could not be found in our database, you need to send a request to create a new brand in the partner portal by pressing the green "Request for a new brand" button. After pressing the button, you will see an automatic window where you fill in all the details of the new brand:
- Brand name
- Brand logo in format JPEG, PNG, GIF
- Short description of the brand
- Translation of short brand description (optional) – translation is not automatic
Once saved, the brand is added to the list of new requests to be created, see picture bellow. The request must then be submitted.
Please send all brand requests at once, otherwise the process may be significantly delayed.
When you press the "Submit Request" button, you will be notified if you actually want to submit the request. If you want to add multiple brands, continue with the "Continue" button and then send the requests all at once.
We must then add the brand in our systems. It usually takes 2-3 working days to process a request.
You can also watch our instructional video (only in Czech)
Adding brands to products according to your connection type:
If you are uploading your products manually, brands are assigned in the "Basic" tab in the "Structure" section. Instructions for manual input can be found here.
If the brand already exists, the system will offer the given brand name.
Heureka XML feed
With the Heureka feed, it is not necessary to check the above lists of established brands, as products with brand information are automatically copied to the MALL portal.
You can find brands in “Heureka feed” tab in your Partner portal by clicking on "Feed status" at the top of the page.
You can see the results of the brands in your feed on the right side of the page.
By clicking on the view icon, you will find a list of brands that have been assigned to products from your feed. All brands are found in the list, which can be filtered according to your choice.
In case the brands were not automatically found by the system, you must send us the information according to the instructions in the section Brand Creation above.
MALL XML feed
If you are using the MALL feed connection type, there is a mandatory brand element within the feed. In this element you must always specify the Brand ID of the brand as it is based in our database. You can find out the Brand ID via the API call described above or in the corresponding menu in the portal.
If the Brand ID of the brand is either wrong in your feed or the brand is not yet established in our system, the message "UNKNOWN BRAND ID ..." will appear in your error log.
In case an error notification occurs, it is necessary to check if the given brand exists in our database. If the brand is not created, please send us the information according to the instructions in the Brand Creation section, as mentioned above.
Within the attributes of "CREATE PRODUCT" call, the product brand is added using brand_id.
The content must be the Brand ID under which the brand is saved in our database. If you send a brand_id with either a wrong Brand ID or a non-existent brand, you need to correct the wording, or if the brand is not established, you need to send us a request following the instructions in the Brand Creation section above.
If an error notification "UNKNOWN BRAND ID" appears, see above (the same as XML Feed).
If a brand is established in our database but some of the information such as the logo or description needs to be modified, please submit your request via the Help Center under this link.