Feed Parameters

The following table gives you an overview of the mandatory and optional attributes, as well as the according data type and an example.

attribute data type mandatory default value description example
additional_image_link text no An additional picture can be added. http://www.example.com/ring_silver1.jpg
adult string (accepted values: "true", "false", "yes", "no", "ja", "wahr", "nein", "falsch", "oui", "vrai", "non", "faux") no Flags products which can only be delivered to people who are at least 18 years old. true
age_group string (accepted values: adult,kids,toddler,infant,newborn) (yes) false Mandatory for products in the categories fashion and accessoires.. newborn
atalanda:additional_product_type_1 string no Provide your categories in this field. If they are not compliant with the atalanda categories, you can do the mapping in the atalanda backend. If you want to use atalanda categories right away, you can find the list of categories here. Schmuck > Ringe
atalanda:additional_product_type_2 string no Provide your categories in this field. If they are not compliant with the atalanda categories, you can do the mapping in the atalanda backend. If you want to use atalanda categories right away, you can find the list of categories here. Schmuck > Ringe
atalanda:additional_product_type_3 string no Provide your categories in this field. If they are not compliant with the atalanda categories, you can do the mapping in the atalanda backend. If you want to use atalanda categories right away, you can find the list of categories here. Schmuck > Ringe
atalanda:boost_sort float (accepted values: 0.0 - 10.0) no Determines the order of products on the shop detail page and in category searches. Products with high values (e.g. 10.0) are displayed first, products with lower values behind. Please balance values carefully (all products better than 7 is not allowed). 5.0
atalanda:delivery_method string (accepted values: nationwide, package_delivery, self_collect) no package_delivery Determines if a product is delivered nationwide, only within the city or if the customer can only collect the product in the store.
  1. nationwide automatically includes package_delivery and self_collect.
    2. nationwide
  2. To explicitly choose between the methods, the values have to be followed by commas.
    3. nationwide,self_collect,
atalanda:ingredients text no Provide the ingredients of the product in this field. You can pass the description either in plain text format or include permitted HTML tags. salt, orange, cranberries, sugar, lemon, juniper, fennel, ginger, chili, cumin
atalanda:nutrien_contents text no Enter here, in the case of food, the nutritional information of the product. You can pass the description either in plain text format or include permitted HTML tags. Nutritional information (per 100g)
Energy: 516 kcal (2157 kJ)
atalanda:preorder_days Integer no 0 Pre-order time of the item. 42
atalanda:properties String no Additional properties for a product or a variant. Author=Dan Brown
Author=Darwin,Release year=2015
atalanda:tax_rate float (accepted values in Germany: 0, 7, 19, in Swiss: 0, 2.5, 3.8, 8.5, in Austria: 0, 10, 13, 20) yes VAT of article in percent. 19
availability string (accepted values: in stock, auf Lager, out of stock, en stock and nicht auf Lager) yes Tells atalanda if product is available. Products marked with "out of stock" / "nicht auf Lager" will not be displayed for customers. in stock
brand string no brand of the product. Swarovski
color string (yes) If item_group_id is set, you also have to set color and / or size. red
description text yes Description of the product - provide as many details as possible. You can pass the description either as plain text format or with allowed HTML-Tags. Wedding ring in silver, surface opal with 6 x 0.018 diamonds, width: 5.9 mm, height: 1.7 mm
energy_efficiency_class string (yes) The energy efficiency class of a product.

For usage in combination with min_energy_efficiency_class and max_energy_efficiency_class to create an energy efficiency label, e.g. A+ (A+++ to D).

If energy_efficiency_class is set, you also need to providemin_energy_efficiency_class and max_energy_efficiency_class.		 permitted values:
  • A+++
  • A++
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • G
gender string (accepted values: female, male, unisex) (yes) Mandatory for products in the categories fashion and accessoires. female
gtin string (yes) Global Trade Item Number (GTIN) is an unique identifier for trade items. If not set, identifier_exists must contain the value false. For checking if a gtin is valid, you can use http://www.gtin.info/check-digit-calculator/ (in German). 4012345678901
id integer yes Unique id within this data feed. 1000
identifier_exists boolean (yes) true If gtin is not set, this attributes needs to have false as value. true
image_link text yes atalanda can basically deal with any kind of image size. Nevertheless, we recommend to provide images as large as possible (for zoom functionality). Benchmarks: 750x750 px for large images and 1500x1500 px for zoom-functionality. http://www.example.com/ring_silver.jpg
item_group_id string no You can set item_group_id in order to group different variants of a product to one product. If item_group_id is set, you also have to set color and / or size. 109873423
link text no You can provide a link to the same product on your own online shop here. If you link back from your shop to atalanda, we can include this link on your atalanda product detail pages. Please contact us if you are interested. http://www.example.com/product/123.html
max_energy_efficiency_class String (yes) The maximum energy efficiency class of a product

To be used in combination with min_energy_efficiency_class and energy_efficiency_class to create an energy efficiency label, for example, A+ (A+++ to D).

If max_energy_efficiency_class is set, min_energy_efficiency_class and energy_efficiency_class have to be set as well.		 permitted values:
  • A+++
  • A++
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • G
min_energy_efficiency_class String (yes) The minimum energy efficiency class of a product.

To be used in combination with max_energy_efficiency_class and energy_efficiency_class to create an energy efficiency label, for example, A+ (A+++ to D).

If min_energy_efficiency_class is set, max_energy_efficiency_class and energy_efficiency_class have to be set as well.		 permitted values:
  • A+++
  • A++
  • A+
  • A
  • B
  • C
  • D
  • E
  • F
  • G
mpn string no A part number (often abbreviated PN, P/N, part no., or part #) is an identifier of a particular part design used in a particular industry. Its purpose is to simplify reference to that part. A part number unambiguously identifies a part design within a single corporation, and sometimes across several corporations. HSC0424PP
price float yes Price in local currency. If you want to display a sales price, keep the normal price in this field and use the sale_price attribute for the lower price. 99.00
product_type string yes Provide your categories in this field. If they are not compliant with the atalanda categories, you can do the mapping in the atalanda backend. If you want to use atalanda categories right away, you can find the list of categories here. Jewellery > Rings
google_product_category string yes Provide your categories in this field. If they are not compliant with the atalanda categories, you can do the mapping in the atalanda backend. If you want to use atalanda categories right away, you can find the list of categories here. Jewellery > Rings
quantity oder g:quantity oder atalanda:quantity integer (yes) Number of products available in store. If the number is smaller than 5 an according message is shown to the customer. If the number is 0 or negative, the product cannot be seen by the customer anymore. If you provide an empty value, atalanda interprets this as "unlimited available". 3
sale_price float no Sales price in local currency, has to be lower than price. Is displayed highlighted, the price will be shown crossed out. 79.00
size string (yes) If item_group_id is set, you also have to set color and / or size. M, 38kg, 24'', etc.
title string yes Title of the product. Should not be longer than 140 characters because of SEO reasons. Wedding ring silver model R305
unit_pricing_base_measure string (accepted values: mg, g, kg, ml, cl, l, cbm, cm, m, qm, sqm, items, stck, stück, rolle, packung, blatt, bogen, st, ro, pa, bl, bg, stk, pair, pairs, Paar, Paare, paire, paires) no Tells atalanda the value to which the basic price has to be calculated. Must be provided with the same unit as unit_pricing_measure. 1kg, 1l
unit_pricing_measure string (accepted values: mg, g, kg, ml, cl, l, cbm, cm, m, qm, sqm, items, stck, stück, rolle, packung, blatt, bogen, st, ro, pa, bl, bg, stk, pair, pairs, Paar, Paare, paire, paires) no Tells atalanda the measure or dimension of the given product. Must be provided with the same unit as unit_pricing_base_measure. 0.5kg, 0.75l
atalanda:services string (accepted values: depending on platform configuration) no Enter the unique identifier of the service here. Services and their identifiers are managed by us. Contact us if you would like to configure services (such as a gift wrapping service) for selected products. free_gift_wrapping, free_weee_take_back

Please notice...

  • The columns google_product_category, product_type, atalanda:additional_product_type_1, atalanda:additional_product_type_2 und atalanda:additional_product_type_3 contains one of your categories. For mapping these to the atalanda categories, please visit https://atalanda.com/admin and select Mappings under the menu-item "API". Alternatively you can directly provide atalanda categories.

  • For using variants, please add an unique group-id, identifiying this product, to the item_group_id column (all variants of a product must have the same group ID). An example for such a product would be a ring made of silver or gold and offered in various sizes. Examples of a product with variants can be found here: XML-Format, CSV-Format.

  • For products with the category clothes, or any of its sub-categories, the fields age_group and gender need to be set. A list of valid values can be found here: https://support.google.com/merchants/answer/188494?hl=en.

Allowed HTML-Tags for description

Allowed HTML-Tags usage example
<a href=""> <a href="https://example.com/wedding_rings/101>wedding ring 101</a> wedding ring 101
<b>, <strong> <b>wedding rings</b>, <strong>wedding rings</strong> wedding rings
<u> <u>matt</u> matt
<br> silver wedding rings, matt surface <br> with 6 x 0.018 diamonds. silver wedding rings, matt surface
with 6 x 0.018 diamonds.
<em> <em>Silver</em> Silver
<p> <p>Lorem ipsum dolor sit amet, consetetur sadipscing elitr.</p> <p>At vero eos et accusam et justo duo dolores et ea rebum.</p>

Lorem ipsum dolor sit amet, consetetur sadipscing elitr.

At vero eos et accusam et justo duo dolores et ea rebum.
<ul>, <li> <ul>
   <li>6 x 0.018 diamonds</li>
   <li>width: 5.9 mm</li>
   <li>height: 1.7 mm</li>
</ul>
  • 6 x 0.018 diamonds
  • width: 5.9 mm
  • height: 1.7 mm
<table>, <thead>, <tbody>, <tr>, <th>, <td> <table>
   <thead>
     <tr>
       <th>Year of publication</th>
       <th>Color</th>
     </tr>
   </thead>
   <tbody>
     <tr>
       <td>1955</th>
       <td>blue</th>
     </tr>
     <tr>
       <td>1963</th>
       <td>green</th>
     </tr>
   </tbody>
</table>

Year of publication Color
1955 blue
1963 green