Feed layout and field details

Home Page > Soporte > Soporte para tiendas > Feed layout and field details

Feed layout

The full list of fields is shown in the table below. The keys used are the following:

  • M are mandatory fields. Your offer will not be displayed on Kelkoo if these fields are not provided!
  • HR are Highly Recommended fields.
  • R are Recommended fields.
  • O are Optional fields.

For a better Product data feed integration, you are expected to respect the following:

  • The XML tag name (4th column of table below)
  • The order of the fields and the separator ‘Tab (t)’ in a text file
  • The data types:
    • Numeric : Only numeric values (no text or symbols), the surcharges are always separated by a dot and not a comma.
    • Date : The date must be formatted YYYY-MM-DD (ex : 2009-10-29)
    • Text : The text fields are limited in number of characters on the display. HTML is not allowed in your feed.

Field details

For certain products, we need specific information such as the year or engine for a car or the size and colour for fashion and accessories categories. These fields must also be included in the feed.

CodeFevad (FR only)XML TAGDATA TYPEDESCRIPTION
135M offer-idtextThe identifier of each article must be unique within your account . It can not be reused from one feed to another for the same country and the same language. If you have multiple feeds to a country, the identifiers of articles in the various feeds must also be unique.
If your codes only appear once in your inventory and comply with the requirements listed below, we recommend that you use for this attribute.
Warning: After submitting an article, you should not change their identifier when updating your data feed .
Warning: After submitting an article, you must not use its identifier to designate a different product later .
1M titletextModel name is limited to 80 characters. Example values: “EOS 400D”, or “Pull-over 100% wool”…
WARNING: Leaving the title field blank will mean the products are dropped by our process.
2M product-urltextLink to offer
URL of product’s page on your own site. The url must start with either “http://” or “https://”.
WARNING: Your offer will not be displayed on Kelkoo if your URL does not begin with http:// or https:// .
136M landing-page-urltextLink to offer

URL of product’s page on your own site. The url must start with either http:// or https://.
WARNING: The landing-page-url differs from the product-url field in the following way:
– Landing-page-url can’t integrate tracking – for instance: Lengow, Beezup, ShoppingFeed….
– Landing-page-url must be the final url seen by the user, and use the domain name of your shop.

3M pricenumericNet price for a typical customer.
Should not include possible reduction from a voucher code…(see dedicated fields below)
4M brandtextProduct’s brand
5M descriptiontextDescription : product specifications. This is free text, limited to 300 characters (no use of html).
6M image-urltextLink to an image of the offer. Enter the largest image available on your site. They should not contain any watermark or logo of trade. It is recommended to provide images on a white background in jpg, png or gif..
Minimum recommended size 300 * 300.
Maximum size 6 600 000 pixels. Examples:
* image 1024 * 768 = 786 432 pixel = OK
* image 1600 * 1200 = 1 920 000 pixel = OK
* image 1518 × 5908 = 8 968 344 pixel = NOT OK
WARNING: Your image will not be displayed on Kelkoo if your URL does not begin with http://.
7M eantextEAN code product, you guarantee a good matching at the product level. We support:
UPC-E (6 digits)UPC-E (
* EAN-8/UCC-8/GTIN-8 (8 digits)
UPC-A/GTIN-12 (12 digits)
* EAN-13/UCC-13/GTIN-13 (13 digits)
ISBN-13 (13 digits for books)
* EAN-14/UCC-14/GTIN-14 (14 digits)
 If you cannot supply EAN codes for a specific reason, please contact your Kelkoo account manager or contact us here
8HR merchant-categorytextCategory :
Please fill with a relevant category name, as this field is used by our categorization process. For example, “Accessories” would be somewhat confusing for our process, while “Car accessories” or “PC tuning accessories” have a much more better chance to to fill the proper category…
9MFeed layout and fields details fevad logoavailabilitynumericAvailability of a product. Accepted values are as follow :
1 = In Stock
4 = Preorder
5 = Available on Order
WARNING: Your offer will not be displayed on Kelkoo if this field is blank
10MFeed layout and fields details fevad logodelivery-costnumericPlease provide here exact amount of your product’s delivery price. This applies only for delivery at home, not for withdrawal in a shop, warehouse, or else…
Warning: Your offer will not be displayed on Kelkoo if this field is blank.
11HRFeed layout and fields details fevad logodelivery-timetextDelivery time for product after order. Example values :
x – y days
x days
x – y hours
y hours
x – y weeks
y weeks
12HR conditionnumericProduct status. Values expected:
0 = new (considered as default value)
1 = used
2 = refurbished
3 = open box
4 = returned
5 = damaged
6 = overstock
7 = liquidation
8 = unknown
9 = download (for pure-bits products)
10 = offers for professional
13HRFeed layout and fields details fevad logoecotaxnumericAccepted values in this field (numeric):
* Offer is not affected by the environmental tax, indicate ‘0’
* Offer is affected but price does not include ecotax, specify the amount of the tax
If the total price of the offer already contains environmental tax, enter ‘0’
14HRFeed layout and fields details fevad logowarrantytextWarranty applied to the offer. Typically expected values:
x years + additional information
x months + additional information
check site
Ex. : 2 years manufacturer warranty, 6 months on site
15R mobile-urltextURL of your ‘mobile website’ containing details of the products and the ‘buy button’ to the corresponding product
16R kelkoo-category-idnumericUnique ID for the category on Kelkoo. For example, in the category Air Conditioner and Fan, indicate catkkid 144801.]
17M mpntextMPN code (manufacturer part number) for product. This helps with the integration of your product.
18O skutextSKU code for product. This helps with the integration of your product.
19R colortextColor of the element. If the item is available in several colors, you can specify multiple colors, or use the delimiter “;”to separate each value.
20R unit-pricetextUnit Price. Ex. 14,56 EUR/kg, 0.14 ? per 100 ml, per 100ml = 14.56
137R unit-price-measuretextThe measure in which the product is sold. E.g. 300 ml if a 300 ml bottle, 0.75 l if a regular sized wine bottle, etc.
138R unit-price-base-measuretextThe base measure in which to show price against. E.g. 100 ml if to show 5.60 eur / 100 ml, 12.90 eur / 0.75 l, etc.
21R offer-typetexteOffer type Mainly 2 possible values : “single” or “bundle”.
22O merchant-infotextThis field allows you to associate additional information to your brand (and not the product). Ex: company overview, points of sale, delivery. (limited to 150 characters, including spaces).
23O currencytextEx. EUR, GBP, DKK etc.
24O image-url-2textLink to an alternative image of the offer. Enter the largest image available on your site. Each image must be different
25O image-url-3textLink to an alternative image of the offer. Enter the largest image available on your site. Each image must be different
26O image-url-4textLink to an alternative image of the offer. Enter the largest image available on your site. Each image must be different
Product features
27R green-producttextEcological product. Indicate whether the product can be considered environmentally friendly (green):
1 = yes
0 = no (or empty = default value)
28R green-labeltextEco-label product. Ex: NF Environment, FSC, Fair Trade, …
29O sales-ranknumericThe classification of this product in terms of sales for the merchant. Lower numbers indicate they are most often sold.
30O unit-quantitynumericThe quantity of contents. Ex: package contains 8 units of toothpaste.
31O made-intextThe country where the product was manufactured.
32O efficiency-classtextEfficiency class of offer (A+++,A++,A+,A,B,C,D,E,F,G).
Shipping Method
33R shipping-methodtextMethod of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala …
34R delivery-cost-2numericAlternativ delivery cost
35R shipping-method-2textMethod of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala …
36R delivery-cost-3numericAlternativ delivery cost
37R shipping-method-3textMethod of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala …
38R delivery-cost-4numericAlternativ delivery cost
39R shipping-method-4textMethod of delivery related charges. Ex Post Office, UPS, DHL, Colissimo, Kiala …
40R zip-codenumericPostal code of the shop. Specific to the U.S., but necessary for all countries to allow geoloc
41O stock-quantitynumericNumber of products in stock
42O shipping-weighttextWeight of the item to shipping.
43O payment-methodstextList of methods of payment accepted (Visa, Paypal …)
Coupon
44R voucher-titletextVoucher title. Limited to 80 characters including spaces
45O voucher-descriptiontextVoucher description. Limited to 180 characters including spaces
Required in France
46O voucher-urltextVoucher url. Link to your voucher page if available, or to your home page otherwise (limited to 20 characters including spaces).
Required in France
47O voucher-codetextVoucher code. Code users have to type to benefit from your site’s voucher. Limited to 20 characters including spaces.
Required in France
48O voucher-start-datedateStarting date for you voucher, formatted as YYYY-MM-DD (ex : 2015-01-29)
49O voucher-end-datedateEnd date for you voucher, formatted as YYYY-MM-DD (ex : 2012-11-29)
Crossed price / Sales
50R price-no-rebatenumericCrossed prices. Price of your offer excluding rebate amount. Will be displayed scratched, next to effective price on rebates periods, and should be ignored otherise. Strictly numeric field (no alphabetical character or symbol…), with a dot as decimal separator (no comma).
51O percentage-promonumericLeave this field empty, Kelkoo will calculate it for you
52O occasiontexteUsed to mark offers for special events like Christmas day, Valentine day, and so on.
53O promo-start-datedateStarting date for promotion. Formatted as YYYY-MM-DD (ex : 2015-10-29).
54O promo-end-datedateEnd date for promotion. Formatted as YYYY-MM-DD (ex : 2015-10-29)
User Agreement
55O user-ratingnumericNote to users. How users rated the product on the merchant site, 1 to 5, with 5 being best
56O nb-reviewsnumericNumber of user reviews. The number of user reviews for this product on the merchant site
57O user-review-linktextThe URL for the user reviews on the merchant site.
58O video-linktextThe URL to a video of the product.
59O video-titletextThe title of the video.
Fashion and accessories
60R fashion-typetextKind of product (tee-shirt, shoes…)
61R fashion-gendertextGender (Man, Woman, Children).
62R fashion-sizetextSize of the product. EX: 36;37;38;39;42;45
19R colortextColor of the element. If the item is available in several colors, you can specify multiple colors, or use the delimiter “;”to separate each value.
Software and video-games
63R software-platformtextePlatform (i.e. XBox, PlayStation 4…)
Real estate (extra)
64R property-typetextValues :
Buy
Renting
Flatsharing
life annuity
Rental investment
65R property-sourcetextSource. values :
Particular
Professional
66R propery-garage-parkingtextValues :
Garage
With garage and parking
With parking
Without garage and parking
67R property-citytextName of the city
68R property-zip-codenumeric 
69R property-number-roomsnumericNumber of bedroom (ex: 1, 2, 3..).
70R property-surfacenumericSurface.
71R property-publication-datedateDate of publication. Format YYYY-MM-DD.
72R property-tenuretextTenure.
Movies (extra)
73R movie-directortextMovie director like Steven Spielberg, Stanley Kubrick, etc.
74R movie-actorstext 
75R movie-formattext(VHS, DVD, Blu-Ray).
76R movie-regiontextZone (e.g. 1 (USA), 2 (Europe), etc.)
77O movie-languagestext 
78O movie-release-datedateFormat YYYY-MM-DD.
79R movie-media-ratingtextePublic. Ex: Interdit aux moins de 18 ans…
CD (extra)
80R music-artisttext 
81R music-mediatext 
82R music-genretext 
83O music-formattext 
84O music-record-labeltext 
85O music-languagetext 
86O music-release-datedateFormat YYYY-MM-DD.
Books (extra)
87R book-authortext 
88R book-formattexteFormat (Poche, broché ..).
89R book-editiontext 
90R book-publishertext 
91O book-genretext 
92O book-languagetext 
93O book-release-datedateFormat YYYY-MM-DD.
94O book-audiencetext 
95O book-number-of-pagestext 
Wine and Champagne (extra)
96R wine-countrytext 
97R wine-yearnumeric 
98O wine-domaintext 
99O wine-zonetext 
100O wine-number-bottlesnumeric 
101O wine-capacitytext 
Tyre (extra)
102R tyre-wet-griptext 
103R tyre-noise-classnumeric 
Mobile phone prepaid (extra)
104R mobilephone-networktext 
105R mobilephone-contract-typetext 
106R mobilephone-contract-lengthtext 
107R mobilephone-contract-total-costnumériquePrix total minimum par an (produits et abonnement combiné).
108R mobilephone-tariffnumeriqueTarif mensuel du forfait.
109R mobilephone-monthly-hourstext 
Cars (extra)
110R vehicle-yearnumeric/td>
111R vehicle-mileagenumeric 
112R vehicle-vendor-typetextValues :
Professional
Particular
113R vehicle-citytext 
114R vehicle-zip-codenumeric 
115R vehicle-doorsnumeric 
116R vehicle-chassistext 
117R vehicle-engine-sizenumeric 
118R vehicle-transmissiontextValue :
Manual
Automatique
Sequential
119R vehicle-fuel-typetext 
120R vehicle-bonus-malusnumericBonus-malus.
121R vehicle-all-fuel-typestextValues :
Petrol
Diesel
Gaz
Electric
Electric+Petrol
Electric+Diesel
Gaz+Petrol
Gaz+Diesel
122R vehicle-consumption-highwaynumeric 
123R vehicle-consumption-citynumeric 
124R vehicle-consumption-mixednumeric 
125R vehicle-electric-consumption-highwaynumeric 
126R vehicle-electric-consumption-citynumeric 
127R vehicle-electric-consumption-mixednumeric 
128R vehicle-co2-emmissionnumeric 
Ticketing (extra)
129R event-zip-codenumeric 
130R event-citytext 
131R event-locationtext 
132R event-start-datedateFormat YYYY-MM-DD.
133O event-end-datedateFormat YYYY-MM-DD.
134R event-genretext 

Select your location