Heureka Element Reference on Mergado Knowledge Base

Element ACCESSORY

Mon, 01 Jan 0001 00:00:00 +0000

Element ACCESSORY#

Basic information#

The ACCESSORY element contains the ITEM_ID of a product that is an accessory to the given product. You can include the ACCESSORY element up to 10 times per product, meaning up to 10 different accessories.

Heureka uses this information primarily within Heureka Marketplace, where after adding a product to the cart it displays a “We also recommend” offer featuring the accessories.

Frequently asked questions#

How do I add the ACCESSORY element if it is missing from the feed?
- In Mergado Editor, go to the Elements page, click the New element button, and enter the name: ACCESSORY.
How do I add multiple ACCESSORY elements to a single product?
- Use the Add a value to a multi-value element rule or the Rewrite rule specifying a specific position. Learn more about multi-value elements.

What Mergado Audit checks for the ACCESSORY element#

ACCESSORY is an optional element, so Mergado Audit does not currently check anything for it.

If you need help, contact our technical support.

Element CATEGORYTEXT

Mon, 01 Jan 0001 00:00:00 +0000

Element CATEGORYTEXT#

Basic information#

The CATEGORYTEXT element should contain the Heureka category path. It is used to classify products from the feed into the correct categories in the Heureka catalogue. It is an important element for pairing products into product cards. A pipe character is used as the category level separator: |

CATEGORYTEXT element specification on the Heureka website
Heureka category tree (XML format)

Frequently asked questions#

How do I set categories according to the Heureka category tree?
- Mergado has a dedicated rule for this: Rename categories in bulk.
Is the CATEGORYTEXT element used for pairing products into product cards?
- Yes, it is one of the main pairing elements (together with PRODUCTNAME).
Is it possible to update CATEGORYTEXT in bulk automatically?
- Yes, if you use the Pairing Bear extension for Mergado, which can process the unmatched products report generated by Heureka. This lets you update thousands of categories in a single click based on Heureka’s own suggestions — provided Heureka’s report includes those suggestions.
Will products on Heureka become unpaired if the CATEGORYTEXT element changes?
- Yes, the products will then go through the pairing process again. The duration depends on Heureka’s capacity.

What Mergado Audit checks for the CATEGORYTEXT element#

Whether the CATEGORYTEXT element is missing or empty for any products.
Whether any product has more than one CATEGORYTEXT element — Heureka only processes the first CATEGORYTEXT occurrence for each item.
The audit flags an invalid separator between category levels or extra separators. (The correct level separator in a Heureka feed is the pipe character |.)
Whether the CATEGORYTEXT element contains only a single value (one level), or an invalid value. The element should contain the full category path down to the deepest level — at a minimum, a category and a subcategory separated by |.
The audit also detects when CATEGORYTEXT contains URLs, which do not belong in this element.

If you need help, contact our technical support.

Element DELIVERY

Mon, 01 Jan 0001 00:00:00 +0000

Element DELIVERY#

Basic information#

The DELIVERY element is just a wrapper for:

DELIVERY_ID (carrier identifier),
DELIVERY_PRICE (shipping cost for prepayment) and
DELIVERY_PRICE_COD (shipping cost for cash on delivery, COD = Cash On Delivery).

These elements specify the shipping cost for the product, including VAT. For each available delivery method, one DELIVERY block will appear in the feed.

The DELIVERY_ID and DELIVERY_PRICE sub-elements are required. The DELIVERY_PRICE_COD sub-element is optional and can be omitted if the product cannot be delivered by a given carrier on cash on delivery terms.

Element DELIVERY_DATE

Mon, 01 Jan 0001 00:00:00 +0000

Element DELIVERY_DATE#

Basic information#

The DELIVERY_DATE element contains the number of days until the ordered product is dispatched. If the product is in stock, DELIVERY_DATE is 0. Heureka does not display this value directly, but converts it into a text description shown next to the online store on the product card:

DELIVERY_DATE		Text on Heureka
0	→	In stock
1–3	→	Within 3 days
4–7	→	Within a week
8–14	→	Within 2 weeks
15–30	→	Within a month
31 and more	→	More than a month
no value	→	Info in store

DELIVERY_DATE can also contain a date in the format YYYY-MM-DD, which is treated as the date from which the product will be available on the market.

Element DESCRIPTION

Mon, 01 Jan 0001 00:00:00 +0000

Element DESCRIPTION#

Basic information#

The DESCRIPTION element contains a long product description. It should be a concise description and specification of the product. It must not contain advertising or promotions — for example, that the product has free shipping or is at a promotional price. These do not belong in DESCRIPTION.

There is no maximum length, but only the first 200 characters are shown in full-text search results.

DESCRIPTION element specification on the Heureka website

Frequently asked questions#

How do I remove HTML tags from DESCRIPTION?
- Use the Strip HTML tags rule in Mergado. This rule can also repair text where HTML entities appear instead of characters with diacritics.
How do I remove links from DESCRIPTION?
- Using the Find and replace rule with regular expressions.
How do I shorten text in DESCRIPTION?
- Use the Truncate value rule to shorten the description to the required length.
How do I wrap the value in DESCRIPTION in CDATA?
- On the Elements page → use the >[c icon on the DESCRIPTION row. Heureka does not require the DESCRIPTION value to be wrapped in CDATA.
How do I format the product description (headings, bullet points, bold text, etc.)?
- Individually — on the Products page via manual editing of the DESCRIPTION element value, where a WYSIWYG editor is available.
- In bulk — using artificial intelligence (AI) and the Mergado Sources extension, which can enhance product descriptions and add HTML formatting.
How do I automatically generate product descriptions using AI?
- Try the Mergado Sources extension.
How do I translate the description in DESCRIPTION into another language?
- For machine translation of the feed into other languages — covering not only DESCRIPTION but also categories, parameters, and product titles — use the Mergado Translate extension. It connects to Google Translate or DeepL and remembers already-translated texts, so you do not have to pay repeatedly for the same translations.
How do I find products with a missing description in DESCRIPTION?
- On the Products page, create a query where you enter the element DESCRIPTION in the search field and choose the is empty condition.
How do I create a unique description in DESCRIPTION if it is duplicated across multiple products?
- Using the Rewrite rule, you can add values from other elements — such as parameters, price, product title, manufacturer, or category — to the DESCRIPTION element. You can append these to the end of the existing description by entering a rewrite mask like this in the Rewrite rule:

%DESCRIPTION%

%PRODUCTNAME% is a quality product by %MANUFACTURER% priced at %PRICE_VAT%.

The exact mask depends on what values your elements contain — adjust it so the resulting text makes sense.

Element EAN

Mon, 01 Jan 0001 00:00:00 +0000

Element EAN#

Basic information#

The EAN element contains the numeric code identifying the product. Heureka supports EAN-13, which consists of 13 digits.

EAN element specification on the Heureka website

Frequently asked questions#

Is the EAN code required for products?
- No, except for advertising in the following Heureka categories: Books, Textbooks, Maps and Guides, Films, Music, and Comics, where EAN is mandatory.
Is EAN used on Heureka for pairing products into product cards?
- It is not used directly for pairing itself, but Heureka generates an unmatched products report in which it suggests products for pairing based on matching EAN codes.
What if I manufacture products myself and do not have an EAN?
- You can obtain your own EAN code by registering with an EAN issuing service. Basic information is available in our article What is an EAN code and where is it useful?.
Can I hide products with a missing EAN in Mergado?
- Yes. Create a query to find such products and apply the Hide product rule to it. You can also use the pre-built automation Hide products with a missing EAN code, which will do it for you.
Can I find products with an invalid EAN in the feed? (e.g. wrong length or containing non-numeric characters)
- Yes, using our pre-built automation that you simply run — it creates a query of products where the EAN does not have the correct length or contains non-numeric characters. The automation is named Find products with an invalid EAN.
How do I filter products by EAN codes in Mergado?
- By creating a query on the Products page, for example:
  - EAN = “<specific number>”, or
  - EAN contains “<specific number>”, or
  - if you want to find products by multiple EAN codes, use the enumeration query.
How do I find duplicate EAN codes?
- On the Elements page, in the value overview for the EAN element. Follow our guide on how to find duplicate values.
Can I filter out products with duplicate EAN codes in Mergado?
- Yes. When importing into Mergado, set the matching elements to EAN only — products with duplicate EAN codes will then not be imported into Mergado. Mergado will remove them during input feed import.

What Mergado Audit checks for the EAN element#

Whether EAN is missing or empty (no value) for any products.
Whether EAN codes are unique and no duplicate values (i.e. the same EAN for multiple products) appear in the feed.
Whether the EAN element contains any invalid value — letters, spaces, hyphens, and similar characters instead of a numeric code are not permitted.
Whether the EAN element has the correct length.

If you need help, contact our technical support.

Element EXTENDED_WARRANTY

Mon, 01 Jan 0001 00:00:00 +0000

Element EXTENDED_WARRANTY#

Basic information#

The EXTENDED_WARRANTY element is just a wrapper for:

VAL (number of months)
DESC (description)

These elements specify the extended warranty for the product. The value of the VAL sub-element is entered as the number of months of the extended warranty — for a three-year warranty, you would enter: 36.

The maximum length of the DESC sub-element is 128 characters.

EXTENDED_WARRANTY element specification on the Heureka website

Frequently asked questions#

How do I display the Extended warranty badge for products on Heureka?
- A guide is available in the article on our blog: How to set up an extended warranty EXTENDED_WARRANTY on Heureka.
Can the extended warranty duration in the XML feed be expressed in years?
- No. According to the Heureka specification, the warranty duration in the EXTENDED_WARRANTY | VAL element must be expressed in months, for example:
  - instead of 3 (meaning years), enter: 36 (meaning months),
  - instead of 5 (years), enter 60 (months), etc.
- In the EXTENDED_WARRANTY | DESC element, you may use years in the description text. The months requirement applies only to the EXTENDED_WARRANTY | VAL element.
How do I set different extended warranty values for different groups of products?
- Use the Bulk rewriting by query rule.

What Mergado Audit checks for the EXTENDED_WARRANTY element#

The audit checks the maximum length of the description in the EXTENDED_WARRANTY | DESC element, which is 128 characters.

If you need help, contact our technical support.

Element GIFT

Mon, 01 Jan 0001 00:00:00 +0000

Element GIFT#

Basic information#

The GIFT element contains a text description of a free gift included with the product. GIFT can appear multiple times in the feed if all those gifts are free with the product, with no additional conditions required to receive them.

When multiple GIFT elements are present, individual gifts can be distinguished using the nested ID attribute. Each gift can optionally have its own identifier.

The maximum text length in the GIFT element is 250 characters.

Element HEUREKA_CPC

Mon, 01 Jan 0001 00:00:00 +0000

Element HEUREKA_CPC#

Basic information#

The HEUREKA_CPC element contains the cost per click. It is the maximum amount the seller is willing to pay for a visitor brought from Heureka to their online store.

A comma is used as the decimal separator: , The maximum possible value of HEUREKA_CPC is 1000.

HEUREKA_CPC element specification on the Heureka website

In connection with setting HEUREKA_CPC, the term bidding is used — i.e. setting an appropriate cost per click.

Element IMGURL

Mon, 01 Jan 0001 00:00:00 +0000

Element IMGURL#

Basic information#

The IMGURL element contains the URL of the main product image. The URL must not contain spaces or diacritics. The image URL can be the same for multiple products — it does not need to be unique.

Minimum requirements for the product image are:

resolution of at least 30,000 pixels, corresponding to approximately 175 × 175 pixels
must not contain watermarks
must not contain discounts, bonuses, or any product awards

The maximum length of the image URL is 255 characters. The maximum image dimensions are 4096 × 4096 pixels; the file size must not exceed 2000 KB (2 MB).

Element IMGURL_ALTERNATIVE

Mon, 01 Jan 0001 00:00:00 +0000

Element IMGURL_ALTERNATIVE#

Basic information#

The IMGURL_ALTERNATIVE element contains the URL of an additional product image that is not the main image. It may show the product from a different angle or display the full packaging.

It can appear multiple times per product in the feed. Heureka does not specify how many alternative images a product may have.

Heureka does not specify the dimensions, minimum resolution, or file size for alternative images. We can assume that the same requirements apply as for the main product image in IMGURL.

Element ISBN

Mon, 01 Jan 0001 00:00:00 +0000

Element ISBN#

Basic information#

The ISBN element applies only to books. It is the unique number of a book edition. Heureka supports the ISBN-10 and ISBN-13 formats. Individual parts of the ISBN code are separated by a hyphen: -

ISBN element specification on the Heureka website

Frequently asked questions#

How do I add the ISBN element if it is missing from the feed?
- In Mergado Editor, go to the Elements page, click the New element button, and enter the name: ISBN.

What Mergado Audit checks for the ISBN element#

Whether the ISBN element contains invalid characters — only numbers and hyphens are permitted.

If you need help, contact our technical support.

Element ITEM_ID

Mon, 01 Jan 0001 00:00:00 +0000

Element ITEM_ID#

Basic information#

The ITEM_ID element is the unique identifier of products in the feed. It is required for both Heureka and Heureka Marketplace.

It can contain at most 36 characters. Permitted characters are: uppercase and lowercase letters without diacritics, numbers, hyphens, and underscores.

ITEM_ID element specification on the Heureka website

Frequently asked questions#

Is ITEM_ID used for pairing products into product cards?
- No, it is not. Pairing uses the product name and category. More information is available in the article Complete Guide to Product Pairing on Heureka Using Mergado.
Can ITEM_ID be duplicated in the feed, i.e. the same value for multiple products?
- No. ITEM_ID must be unique for every product, so that Heureka can correctly identify the product within the Verified by Customers service or in the availability feed, where ITEM_ID is used as the unique identifier.
- Instructions for finding and hiding products with duplicate ITEM_ID values are described in the guide How to find duplicate values.
What if ITEM_ID is missing from my feed — can I fix this in Mergado?
- Yes. Using the Rewrite rule, you can populate the ITEM_ID element with the Mergado system variable @MERGADO_ID, which contains a unique number for every product. This gives you unique values for each ITEM_ID.
- You can also use the pre-built automation named ITEM_ID from MERGADO_ID, which you simply run.
- Other options: hide products with a missing ITEM_ID using the Hide product rule, or import values into ITEM_ID using the Data file import rule.
What is the difference between ITEM_ID and ITEMGROUP_ID?
- ITEM_ID must be unique for every product, whereas values in ITEMGROUP_ID can be the same (duplicated) for variants of the same product. ITEMGROUP_ID is the shared identifier for product variants.
How do I filter products with specific ITEM_ID values?
- Create a query on the Products page in Mergado for the ITEM_ID element values using the enumeration condition — is contained in the enumeration.

What Mergado Audit checks for the ITEM_ID element#

Whether the ITEM_ID element is missing or empty for any products.
Whether the ITEM_ID element has the correct length (maximum 36 characters) and does not contain invalid characters. Only underscores, hyphens, numbers, and letters without diacritics are permitted. Spaces and letters with diacritics are not allowed in ITEM_ID.

If you need help, contact our technical support.

Element ITEM_TYPE

Mon, 01 Jan 0001 00:00:00 +0000

Element ITEM_TYPE#

Basic information#

The ITEM_TYPE element is used to mark a product that is not new. In that case, the value bazar is entered in this element.

ITEM_TYPE element specification on the Heureka website

Frequently asked questions#

Is it possible to advertise used or open-box products on Heureka?
- Yes. For these products, the value bazar must be entered in the ITEM_TYPE element. Such a product will not appear in product cards within categories, but it can be found via Heureka’s full-text search.

What Mergado Audit checks for the ITEM_TYPE element#

Whether the ITEM_TYPE element contains invalid values — it may only contain new or bazar.

If you need help, contact our technical support.

Element ITEMGROUP_ID

Mon, 01 Jan 0001 00:00:00 +0000

Element ITEMGROUP_ID#

Basic information#

The ITEMGROUP_ID element is the shared identifier for products forming variants. Heureka requires product variants to be listed as separate SHOPITEMs. This means each variant — for example a specific size or colour — is listed in the feed as a separate product. Using ITEMGROUP_ID, you can mark individual groups of variant products with the same code, the group ID.

Like ITEM_ID, the ITEMGROUP_ID element can contain at most 36 characters. Permitted characters are: uppercase and lowercase letters without diacritics, numbers, hyphens, and underscores.

Element MANUFACTURER

Mon, 01 Jan 0001 00:00:00 +0000

Element MANUFACTURER#

Basic information#

The MANUFACTURER element should contain the name of the product manufacturer, or the brand under which the product is known. The value from this element is used for filtering within categories on Heureka.

MANUFACTURER is not used for pairing products into product cards, which is why the manufacturer must also be included in the product name — i.e. in the PRODUCTNAME element — for every product in the feed.

Element PARAM

Mon, 01 Jan 0001 00:00:00 +0000

Element PARAM#

Basic information#

The PARAM element is a wrapper for:

PARAM_NAME (the parameter name) and
VAL (the parameter value).

These three elements are used to specify product parameters. The number of PARAM blocks in the feed matches the number of parameters the product has.

Parameters are used on Heureka to filter products within a category.

PARAM element specification on the Heureka website

Note: for some products, the mandatory parameters must also be present in the product name, in the PRODUCTNAME element.

Element PRICE_VAT

Mon, 01 Jan 0001 00:00:00 +0000

Element PRICE_VAT#

Basic information#

The PRICE_VAT element contains the final price including VAT and any applicable copyright or recycling fees. The decimal separator can be either a comma , or a period ., with a maximum of 2 decimal places. No currency symbol should be included.

PRICE_VAT element specification on the Heureka website

Frequently asked questions#

Is it possible to adjust prices automatically based on the competition?
- Yes, use the Mergado extension Pricing Fox. It automatically adjusts prices based on competitor price movements and your defined requirements, to keep your offer as competitive as possible.
How do I round prices in PRICE_VAT?
- Use the Round numbers rule. Keep in mind that the price in the output feed must match the price displayed in your online store. Use the same rounding type you apply to prices in your store.
How do I convert a currency using an exchange rate — for example from EUR to CZK or from CZK to EUR for the Slovak Heureka?
- Use the Calculation rule with a fixed or dynamic coefficient (variable). A step-by-step guide is available in the article Convert currencies easily with Mergado on our blog.
Should the PRICE_VAT element include the currency?
- No. Enter only the numerical value in this element — the amount without any currency symbol (CZK, EUR, etc.).
What price should PRICE_VAT show when a discount voucher SALES_VOUCHER is used?
- If a product has a discount voucher (see the SALES_VOUCHER element), PRICE_VAT must contain the price after the voucher has been applied.

What Mergado Audit checks for the PRICE_VAT element#

Whether the PRICE_VAT element is missing or empty for any products.
Whether the PRICE_VAT element contains a positive number. The price including VAT must always be a positive number.
Whether the value is not unreasonably high — for example, whether it exceeds 1,000,000 CZK, which could indicate a typo.
In connection with the VAT element, the audit checks whether both PRICE_VAT and VAT are present in the feed — for example, if prices are specified in the PRICE element (i.e. without VAT), the VAT element should not be missing from the feed.

If you need help, contact our technical support.

Element PRODUCT

Mon, 01 Jan 0001 00:00:00 +0000

Element PRODUCT#

Basic information#

PRODUCT should contain the same value as PRODUCTNAME plus any additional information. It is the extended product name.

The additional information may include, for example, the expiry date, product distribution details, or clarifications for in-store pickup.

The maximum length is 255 characters for full-text search display, and 200 characters for a product card.

PRODUCT element specification on the Heureka website

Frequently asked questions#

Does the PRODUCT element have to be present in the feed?
- No, it does not — as long as PRODUCTNAME is in the feed.
How do I put the same content into PRODUCT as in PRODUCTNAME?
- Use the Bulk copy values rule to copy the content of the PRODUCTNAME element into the PRODUCT element. This overwrites the existing value in PRODUCT with the value from PRODUCTNAME.
What additional information can the PRODUCT element contain beyond PRODUCTNAME?
- For example: expiry date, product distribution details, or clarifications for in-store pickup.
What information may the PRODUCT element not contain?
- It must not contain:
  - Information about an extended warranty — use the EXTENDED_WARRANTY element for that.
  - Additional services such as upper-floor delivery, appliance service/replacement/installation, etc. — use the SPECIAL_SERVICE element for these.
  - Information about free shipping — use the DELIVERY element for that.
  - Information about product availability — use the DELIVERY_DATE element or a separate availability feed supported by Heureka.
  - Further examples are available in the PRODUCT element specification on the Heureka website.

What Mergado Audit checks for the PRODUCT element#

Whether PRODUCT is not duplicated — i.e. whether it is unique for every product in the feed.
Whether the PRODUCT element has the correct length (no more than 255 characters).
The audit also flags when PRODUCT contains additional words such as “instalments”, “sale price”, “in-store pickup”, URLs, or non-standard characters.

If you need help, contact our technical support.

Element PRODUCTNAME

Mon, 01 Jan 0001 00:00:00 +0000

Element PRODUCTNAME#

Basic information#

PRODUCTNAME is the exact product name. It is a required element in a Heureka feed. It is used for product pairing. For certain product categories it must meet Heureka’s requirements — for example, clothing names must include the size. At the same time, it must not contain additional details unrelated to the product name, such as gifts, warranty information, or similar. The maximum length is 200 characters.

Element SALES_VOUCHER

Mon, 01 Jan 0001 00:00:00 +0000

Element SALES_VOUCHER#

Basic information#

The SALES_VOUCHER element is a wrapper for:

CODE (the discount voucher code) and
DESC (the description of the discount offer).

These three elements are used to provide a discount code for a given product to users. The value of the CODE sub-element is the discount code, which the customer then uses in your online store during checkout. If the offer is time-limited, it is recommended to include the expiry date in the DESC sub-element.

Element SHOP

Mon, 01 Jan 0001 00:00:00 +0000

Element SHOP#

Basic information#

SHOP is the root element of a Heureka product feed. The actual data starts with this element (the only thing before it is the header — the line defining the XML version and character encoding, usually in the form <?xml version="1.0" encoding="utf-8"?>).

SHOP element specification on the Heureka website.

Frequently asked questions#

Can the SHOP element appear more than once in a Heureka feed?
- No, it must appear exactly once. That is, the feed starts with the opening tag <SHOP> and ends with the closing tag </SHOP> — it must not appear anywhere else in the feed.

What Mergado Audit checks for the SHOP element#

Whether the SHOP root XML tag appears exactly once and is not duplicated in the feed.
Whether the SHOP element is not missing from the feed.

If you need help, contact our technical support.

Element SHOPITEM

Mon, 01 Jan 0001 00:00:00 +0000

Element SHOPITEM#

Basic information#

SHOPITEM is the wrapper element for products. It appears in the feed as many times as you have products. If your products have variants — such as clothing sizes, perfume bottle volumes, etc. — each product variant must have its own SHOPITEM. Heureka requires product variants to be listed as separate items in the feed.

SHOPITEM element specification on the Heureka website

Frequently asked questions#

If the input feed contains merged variants, will those items be split into separate SHOPITEMs automatically?
- Yes, but you need to select the appropriate input format when creating a new project. For example, for Shoptet, Upgates, Malfini, and other integrations that can generate merged variants, you need to select the version of the given format labelled “product variants as separate items” as the input format in Mergado. This ensures that any variant products in the input feed are automatically split into separate SHOPITEMs when imported into Mergado.

What Mergado Audit checks for the SHOPITEM element#

Whether the products in the feed contain any data inside the <SHOPITEM> … </SHOPITEM> elements — i.e. whether there are no “empty products”.
Whether any element in the feed appears outside the <SHOPITEM> … </SHOPITEM> wrapper tags.

If you need help, contact our technical support.

Element SPECIAL_SERVICE

Mon, 01 Jan 0001 00:00:00 +0000

Element SPECIAL_SERVICE#

Basic information#

The SPECIAL_SERVICE element is used to specify additional services included with a product purchase, such as: “Upper-floor delivery included” or “Appliance installation included”. Each product in the feed may include this element up to 5 times, meaning a maximum of 5 additional services can be listed per product.

The maximum text length for the SPECIAL_SERVICE element is 128 characters.

SPECIAL_SERVICE element specification on the Heureka website

Frequently asked questions#

How many SPECIAL_SERVICE elements can each product have?
- A maximum of 5.
How do I add the SPECIAL_SERVICE element if it is missing from the feed?
- On the Elements page, first create a new element named SPECIAL_SERVICE, then go to the Rules page to populate it with a value. If you want to add SPECIAL_SERVICE more than once for a product — to create the second through fifth values — use the Add a value to a multi-value element rule, or the Rewrite rule together with a specific position.
What may SPECIAL_SERVICE contain?
- For example:
  - Appliance installation included
  - Assembly included
  - Free service
  - Packaging removal/disposal
  - Upper-floor delivery
  - Extended warranty/post-warranty service
  - Extended return period
  - and others.
What must SPECIAL_SERVICE not contain?
- Any discounts, promotions, bonuses, instalment payment information, in-store pickup or free shipping details (use DELIVERY for that), mentions of authorised resellers, or availability information (use DELIVERY_DATE for that).

What Mergado Audit checks for the SPECIAL_SERVICE element#

The audit checks the maximum text length of each SPECIAL_SERVICE element — it must not exceed 128 characters.
The audit also monitors the maximum allowed number of these elements per product, which is 5. This check is especially important because if a product has SPECIAL_SERVICE more than 5 times, Heureka will ignore all the information from all those elements.

If you need help, contact our technical support.

Element URL

Mon, 01 Jan 0001 00:00:00 +0000

Element URL#

Basic information#

The URL element contains the link to a specific product in your online store, where the product can be added to the cart. The product URL must be unique across all products in the feed.

The maximum length is 300 characters.

URL element specification on the Heureka website

Frequently asked questions#

How do I add UTM parameters to the URL?
- Use the Set UTM parameters rule, which is designed specifically for this purpose.
How do I remove UTM and other parameters from the URL?
- Use the Find and replace rule with regular expressions.
How do I fix duplicate URLs, for example for product variants?
- Using the Rewrite rule, you can append a # character to the end of URLs followed by the system variable @@MERGADO_ID, which is unique for every product in the feed. Example of the rewrite mask in the rule: %URL%#%@@MERGADO_ID% This way you turn duplicate URLs into unique ones without affecting the actual link to the product page in your online store.
Will products on Heureka become unpaired if their URL changes?
- Yes, however if the other values in the key pairing elements (PRODUCTNAME and CATEGORYTEXT) have not changed, Heureka will soon pair the product back into its product card.

What Mergado Audit checks for the URL element#

Whether the URL element is missing or empty for any products.
Whether the URL is not duplicated — i.e. whether it is unique for every product in the feed.
The audit also verifies the correct URL format.

If you need help, contact our technical support.

Element VAT

Mon, 01 Jan 0001 00:00:00 +0000

Element VAT#

Basic information#

The VAT element contains the value-added tax (VAT) rate expressed as a percentage — for example, 21 %. It is required for products with a different (reduced) VAT rate in Heureka Cart.

VAT element specification on the Heureka website

Frequently asked questions#

What number format should VAT use?
- It should be a whole number, ideally including the % sign — for example, 21 %.
How do I fix VAT if it contains a decimal number such as 0.21?
- You can either use the Rewrite rule to change the value to the specific tax rate, or use the Calculation rule to multiply by 100 (the formula in the rule would be: %VAT%*100).

What Mergado Audit checks for the VAT element#

Whether the VAT element contains an invalid value — it should contain the VAT rate in percent, for example 21 %.
In connection with the PRICE_VAT element, the audit checks whether both VAT and PRICE_VAT are present in the feed — for example, if prices are specified in the PRICE element (i.e. without VAT), the VAT element should not be missing from the feed.

If you need help, contact our technical support.