Technical requirements

YML detection

YML (Yandex Market Language) is a standard developed by Yandex for receiving and placing information from stores. YML is based on the XML (XML XSD) standard. The common format allows to process the information from stores about products and services quickly and effectively.

Configure import and export of information about products and services from your database to the YML file. Use CMS with built-in data export in YML format. Place the file on your store's site using the URL specified in the “Products and prices” section. The YML file is regularly downloaded by the robot. The updated data is exported to the database.

XML XSD in the YML file

YML file template

For examples of using the elements, see the Examples and descriptions section.

To prepare the YML file, follow the guidelines below.

Terms and recommendations for transmitting data

  1. The YML file must be accessible via HTTP or HTTPS. You can use authorization to access this file. In this case, when uploading a file, specify the login and password for the robot to download.

    If you change the URL and/or authorization data, you need to make changes in the “Products and prices” section.

  2. The YML file can be dynamic and generated at the robot's request, but this is a very resource-intensive approach. It is preferable to use a static YML file that is updated regularly at a certain time or for a specific event, for example, after each update of your store's database.
  3. The YML file can be divided into several parts. In this case, you need to upload individual files to Yandex.Webmaster one by one.
  4. You can compress the YML file with ZIP (.zip extension) or GNU ZIP (.gz extension).

  5. The maximum size of the YML file is 500 MB.

  6. You can't use elements with empty values ​​in the YML file. If an element isn't required and it isn't applicable in your case, remove it.

  7. Don't use spaces and Cyrillic letters in the links in the YML-file. Otherwise, the YML file will be rejected at validation.

  8. The site URL should be specified in the same way in Yandex.Webmaster: either with or without the www prefix, using the HTTP or HTTPS protocol.

  9. The YML standard doesn't allow non-printable characters with ASCII codes in the range from 0 to 31 (except characters with codes 9, 10, 13 — tab, newline, carriage return) in the links or text data. You have to replace the characters with the equivalent character codes:

    Character in the text Code for the YML file

    "

    "

    &

    &

    >

    >

    <

    <

    '

    '

Examples and descriptions

XML header

This is a standard XML header with a link to the format description file. The header should begin from the first line, from the zero character.

The second line of the XML document header specifies the link to the data format description file (XML DTD). Just the file name shops.dtd is enough. You don't have to specify the path.

<?xml version="1.0" encoding="windows-1251"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">

yml_catalog

An XML document can contain only one root element. The YML format uses yml_catalog as the root element. The date attribute of the yml_catalog element must match the date and time of the YML file generation on the store's side. The date must be in the YYYY-MM-DD hh:mm format.

<yml_catalog date="2010-04-01 17:00">
  <shop>
    ...
  </shop>
</yml_catalog>

shop

The shop element contains the store description and its product offers.

<shop>
    <name>BestShop</name>
    <company>Best online seller Inc.</company>
    <url>http://www.best.seller.ru/</url>

    <currencies> ... </currencies>
    <categories> ... </categories>
    <delivery-options> ... </delivery-options>
    <offers> ... </offers>
</shop>
Note. The store name in thename element can be up to 20 characters. Otherwise, it will automatically be replaced with the domain name specified in the url item.

currencies

The currencies element sets the list of the store's exchange rates. Each currency is described with a separate currency element.

Information about prices is accepted in rubles (RUR, RUB), hryvnias (UAH), Belarusian rubles (BYN), tenge (KZT), dollars (USD) and euros (EUR). In search results, prices can be displayed in rubles, hryvnias, Belarusian rubles and tenge, depending on the user's region. If your YML file doesn't contain the rate for the displayed currency, then the rate of the Central Bank in the user's country is applied. The country is detected by the user's region. The rate is taken for the current day. The rate is updated daily at 00.00.

<currencies>
    <currency id="RUR" rate="1"/>
    <currency id="USD" rate="23.98"/>
    <currency id="EUR" rate="CBRF"/>
    <currency id="UAH" rate="NBU"/>
    <currency id="KZT" rate="CB"/>
</currencies>

The id attribute of the <currency> element specifies the code for one or more currencies that can be used in the YML file.

The rate attribute indicates the exchange rate to the basic currency taken for the unit (the currency for which rate = "1"). The rate attribute can have the following values:

  • A constant number — The internal rate you use.

  • CBRF — The Russian Federation Central Bank rate.

  • NBU — The National Bank of Ukraine rate.

  • NBK — The National Bank of Kazakhstan rate.

  • CB — The bank rate of the country to which the store belongs by the region specified in the partner interface.

The main currency (for which the rate = "1" is set) can be only ruble (RUR, RUB), Belarusian ruble (BYN), hryvnia (UAH) or tenge (KZT).

In this example, dollar and euro have the rate of the National Bank of Ukraine:

<currencies>
    <currency id="UAH" rate="1"/>
    <currency id="USD" rate="NBU"/>
    <currency id="EUR" rate="NBU"/>
</currencies>

categories

The categories element contains the list of categories of the store. Each category is described in a separate category element. A category description should include its identifier (the id attribute) for all categories and a higher category identifier for subcategories. The category ID must be a unique positive integer (can't be equal to “0”). If the parentId element isn't specified, the category is considered the root category.

Parameters:

  • id — The ID of your product category.

  • parentId — The ID of the parent product category (higher in the hierarchy).

<categories>
    <category id="1">Books</category>
    <category id="2" parentId="1">Mystery</category>
    <category id="3" parentId="1">Action</category>
    <category id="4">Videos</category>
    <category id="5" parentId="4">Comedy</category>
    <category id="6">Printers</category>
    <category id="7">Office equipment</category>
</categories>

local_delivery_cost

Attention. The local_delivery_cost element is obsolete. We recommend that you don't use this element and switch to the delivery-options element. The new element provides more functionality.

The local_delivery_cost element indicates the total shipping price for the region in which the store is located.

You can specify the delivery price for each product in the local_delivery_cost element nested in offer .

If the YML file contains the total shipping price, it applies to all products unless the shipping price is indicated in the offer element.

<shop>
    <currencies> ... </currencies>
    <categories> ... </categories>
    <local_delivery_cost>300</local_delivery_cost>
    <offers>
      <offer>...</offer>
      ...
    </offers>
</shop>

delivery-options

Use the element to specify the price of the courier service for your region.

Include the information in the cost attribute option element.

The delivery-options element must be nested at the shop element level. Otherwise the YML file doesn't pass validation. The price specified in the base currency of the price list.

The delivery-options can be nested at the offer element level. In this case, the value specified in the currency of the offer.

The value must be an integer (rubles). For free delivery, use the "0" value. Note general rules for specifying the shipping price:

  • If the delivery price depends on the city district, we recommend that you specify the maximum as the delivery price around the city (your region) to avoid quality issues.
  • If the shipping price isn't fixed and depends on various parameters (weight, volume, and so on), specify the minimum price for delivery of one item. For example, if the products are sold in boxes (the minimum is one item in a box), specify the shipping price for one box. If the product is sold in kilos, specify the delivery price for 1 kg.

The delivery-options element can contain up to five option elements for various delivery types and conditions (for example, regular, express, and so on).

The option allows additional attributes (days, order-before). Yandex.Market takes these attributes into account but they aren't used in the partner program snippet.

For examples of using the delivery-options element, see the Yandex.Market help section.

offers

The offers element lists the stores' product offers. Each product offer is described in a separate offer element.

<offers>
  <offer>
    <offer id="123" type="vendor.model" available="true">
      ...
    </offer>
  ...
</offers>

There are several types of product offer descriptions in the YML file. The type determines which fields are used to describe the offer.

The description type is indicated in the type attribute of theoffer element.

<offer id="123" type="vendor.model" available="true">
  <url>...</url>
  ...
</offer>

Simplified description

description and name

The name element indicates the product offer title (up to 120 characters). Specify the full unique name of the product in the title. The title can't consist of numbers only.

The description element specifies the product offer description (up to 175 characters). We recommend to specify the main characteristics of the product in the product offer description.

The description is used to replace the automatically generated snippet text in the search results. The text is replaced when it is of poor quality.

Note. It isn't allowed to use xhtml elements in the description and name elements (for example, h3, br, and so on).
<offer>
  <name>Ormatek Mono Prim EVS500 orthopedic mattress</name>
  <description>One side medium hard mattress with independent pocket springs EVS 500. 
  Spreads the weight evenly across the horizontal surface
  and provides support for the spine.   Fillers: polyurethane foam  and latex coconut coir. Size: 90x195 cm, height: 17 cm.
  Maximum weight per single bed: 100 kg.</description>
</offer>

adult

The adult element is required for a product that deals with satisfaction of sexual needs or exploits interest in sex in any other way.

The store's offers marked with the adult tag will be displayed in the Yandex.Market block on the Yandex search results page when the family filter is off, and only for specific search queries. In the Yandex.Market search, these offers will be displayed only if the user confirms reaching the age of 18 years.

The adult element can be specified:

  • Before the offers element to mark the whole list of product offers.
  • In the element offer for individual product offers.
<adult>true</adult>
<offers>
    <offer>...</offer>
    ...
</offers>

<offer>
    ...
    <typePrefix>Gel vibrator</typePrefix>
    <vendor>Robotic</vendor>
    <model>Realistic 9</model>
    ...
    <adult>true</adult>
    ...
</offer>

vendor

The vendor element indicates the product manufacturer or trademark.

You can use the vendor element in two types of product descriptions: simplified description and vendor.model. When describing the product, you should always specify the manufacturer or trademark.

<offer>
  <vendor>Nokia</vendor>
</offer>

Types of descriptions

The offer element supports several types of offer descriptions. We recommend using different types of descriptions for different offer categories. It will simplify the YML file preparation, if you want to place your offers in Yandex.Market.

Restriction. Elements not included in the examples are redundant. They aren't processed. Yandex reserves the right to change the type of snippets.

Arbitrary product (vendor.model)

This description type is the most convenient and universal. It is recommended for describing products from most categories.

<offer id="12341" type="vendor.model" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=12344</url>
    <price>700</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <delivery>true</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <typePrefix>Printer</typePrefix>
    <vendor>НP</vendor>
    <vendorCode>CH366C</vendorCode>
    <model>Deskjet D2663</model>
    <description>Printer series for people who need a reliable, 
    easy-to-use color printer for everyday use. A4 format. Printing technology: 4-color thermal inkjet. 
    Printing resolution: 4800х1200 dpi
    </description>
    <manufacturer_warranty>true</manufacturer_warranty>
    <country_of_origin>Japan</country_of_origin>
    <param name="Maximum format">А4</param>
    <param name="Printing technology">thermal jet</param>
    <param name="Printing type">Color</param>
    <param name="Pages per month" unit="стр">1000</param>
    <param name="Wattage" unit="W">20</param>
    <param name="Weight" unit="kg">2.73</param>

</offer>

Elements nested in offer (required elements in the table are in bold):

Element Description

url

The URL of the product page. The URL can be up to 512 characters.

price

The price at which this product can be purchased. The price of the product offer is rounded. The format in which it is displayed depends on the user's settings.

The specified value must not be zero.

currencyId

The product currency ID (RUR, USD, UAH, KZT). To display the product price correctly, use the identifier (for example, UAH) with the price value.

categoryId

The product category ID (an integer up to 18 characters). A product offer can belong to only one category.

delivery

Element that indicates if delivery is offered for the product.

“false” — The product can't be delivered (“Pick up”).

“true” — The product is delivered to the regions indicated in the “Shop” tab in the “Products and prices” section. The shipping price is described in the <local_delivery_cost> tag.

typePrefix

Product group/category.

vendor

Manufacturer.

model

Model. The model name can't contain only numbers. Apart from numbers the model name must contain letters.

description

Product offer description

The description is used to replace the automatically generated snippet text in the search results. The text is replaced when it is of poor quality.

vendorCode

The product code (the producer's code).

local_delivery_cost

The delivery price for the product in the region.

available

Product availability status — in stock/on request.

“false” — The product is available on request. The store can deliver the product on the specified conditions within a month (the term may be longer for the goods offered only on request by all sellers). The products that can't be ordered shouldn't be uploaded.

“true” — The product in stock. The shop is ready agree with the buyer on delivery of the product.

sales_notes

The element is used for the minimum order value, the minimum product amount or the pre-payment requirements, as well as to describe the store's actions. The text can be up to 50 characters.

manufacturer_warranty

The element is used to mark the products that have official warranty from the manufacturer.

country_of_origin

The element is used to indicate the country of origin of the product. The list of countries that can be specified in this element is available at: http://partner.market.yandex.ru/pages/help/Countries.pdf.

downloadable

The element is used to mark a product that you can download.

adult

The element is required for a product that deals with satisfaction of sexual needs or exploits interest in sex in any other way.

param

The element is used for the product characteristics. For each parameter, a separate <param> element is used. The element is optional.

Books (book)

<offer id="12342" type="book" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=14345</url>
    <price>80</price>
    <currencyId>RUR</currencyId>
    <categoryId>3</categoryId>
    <delivery>true</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <author>Alexandra Marinina</author>
    <name>Everything's Gone Wrong In 2 volumes. Volume 1</name>
    <publisher>EKSMO Press</publisher>
    <series>A. Marinina — the mystery queen</series>
    <year>2007</year>
    <ISBN>978-5-699-23647-3</ISBN>
    <volume>2</volume>
    <part>1</part>
    <language>rus</language>
    <binding>70x90/32</binding>
    <page_extent>288</page_extent>
    <description>Everything is perfectly in the big patriarchal Rudenko family. Alas, nothing is what it seems: each of the numerous representatives of the family have plenty of secret passions and forbidden desires. </description> <downloadable>false</downloadable> </offer>

Elements nested in offer (required elements in the table are in bold):

Element Description

url

The URL of the product page. The URL can be up to 512 characters.

We don't recommend using spaces and Cyrillic characters in the URLs in the YML-file. This can make the file invalid.

price

The price at which this product can be purchased. The price of the product offer is rounded. The format in which it is displayed depends on the user's settings.

The specified value must not be zero.

currencyId

The product currency ID (RUR, USD, UAH, KZT). To display the product price correctly, use the identifier (for example, UAH) with the price value.

categoryId

The product category ID (an integer up to 18 characters). A product offer can belong to only one category.

delivery

Element that indicates if delivery is offered for the product.

“false” — The product can't be delivered (“Pick up”).

“true” — The product is delivered to the regions indicated in the “Shop” tab in the “Products and prices” section. The shipping price is described in the <local_delivery_cost> tag.

author

The author of the book.

name

The book title.

publisher

Publishing house.

series

Series.

year

Year of publishing.

ISBN

The book's code. If there are several codes, separate them with a comma.

The ISBN format is validated. The validation checks:

  • The code length. The ISBN split with hyphens (for example, 978-5-94878-004-7) is checked for compliance with the additional requirements for the number of digits in each of the parts.
  • Control number (check-digit). The last digit in the code should correspond to the rest of the numbers according to a certain formula.

Optional element.

description

Annotation for the book.

volume

Number of volumes.

part

Volume number.

language

Language of the book.

binding

Book cover.

page_extent

The number of pages in the book. Must be a positive integer.

table_of_contents

Table of contents. Names of the items if the book is a collection of stories or verses.

Audiobooks (audiobook)

<offer id="12342" type="audiobook" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=14345</url>
    <price>200</price>
    <currencyId>RUR</currencyId>
    <categoryId>3</categoryId>
    <author>Vladimir Kunin</author>
    <name>Ivanov and Rabinovich</name>
    <publisher>1S Publishing, Soyuz</publisher>
    <year>2008</year>
    <ISBN>978-5-9677-0757-5</ISBN>
    <language>ru</language>
    <performed_by>Nikolai Fomenko</performed_by>
    <performance_type>read </performance_type>
    <storage>CD</storage>
    <format>mp3</format>
    <recording_length>45m23s</recording_length>
    <description>Vladimir Kunin is the author of dozens of movie scripts, book series, and more.</description>
    <downloadable>true</downloadable>
</offer>

Elements nested in offer (required elements in the table are in bold):

Element Description

url

The URL of the product page. The URL can be up to 512 characters.

We don't recommend using spaces and Cyrillic characters in the URLs in the YML-file. This can make the file invalid.

price

The price at which this product can be purchased. The price of the product offer is rounded. The format in which it is displayed depends on the user's settings.

The specified value must not be zero.

currencyId

The product currency ID (RUR, USD, UAH, KZT). To display the product price correctly, use the identifier (for example, UAH) with the price value.

categoryId

The product category ID (an integer up to 18 characters). A product offer can belong to only one category.

author

The author of the book.

name

The book title.

publisher

Publishing house.

series

Series.

year

Year of publishing.

ISBN

The book's code. If there are several codes, separate them with a comma.

The ISBN format is validated. The validation checks:

  • The code length. The ISBN split with hyphens (for example, 978-5-94878-004-7) is checked for compliance with the additional requirements for the number of digits in each of the parts.
  • Control number (check-digit). The last digit in the code should correspond to the rest of the numbers according to a certain formula.

Optional element.

description

Annotation for the book.

performed_by

Performed by If there are several of them, they are separated by commas.

performance_type

The type of audiobook (radio drama, a story read aloud, ...).

language

Language of the book.

volume

Volume number.

part

Part number.

format

Audiobook format.

storage

The media the audiobook is provided on.

recording_length

The recording length is set in the mm.ss (minutes.seconds) format.

table_of_contents

Table of contents. Names of the items if the book is a collection of stories or verses.

Music and video production (artist.title)

Example for music

<offer id="12345" type="artist.title" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=12946</url>
    <price>15</price>
    <currencyId>USD</currencyId>
    <categoryId>2</categoryId>
    <delivery>true</delivery>
    <artist>Pink Floyd</artist>
    <title>Dark Side Of The Moon, Platinum Disc</title>
    <year>1999</year>
    <media>CD</media>
    <description> Dark Side Of The Moon turned the world upside down with its unheard-of combinations of sounds, but it's just nine tracks, and not all of them were written for the album. 
    The Pink Floyd participants searched around and made     something new from the old stuff — the songs that     for some reason weren't issued or stayed unfinished. 
    One of the sources for its inspiration was the large number of soundtracks for movies that the group created.</description>
</offer>

Elements describing music in offer (required elements in the table are in bold):

Element Description

url

The URL of the product page. The URL can be up to 512 characters.

We don't recommend using spaces and Cyrillic characters in the URLs in the YML-file. This can make the file invalid.

price

The price at which this product can be purchased. The price of the product offer is rounded. The format in which it is displayed depends on the user's settings.

The specified value must not be zero.

currencyId

The product currency ID (RUR, USD, UAH, KZT). To display the product price correctly, use the identifier (for example, UAH) with the price value.

categoryId

The product category ID (an integer up to 18 characters). A product offer can belong to only one category.

delivery

Element that indicates if delivery is offered for the product.

“false” — The product can't be delivered (“Pick up”).

“true” — The product is delivered to the regions indicated in the “Shop” tab in the “Products and prices” section. The shipping price is described in the <local_delivery_cost> tag.

artist

Performed by

title

Title.

year

The year of publishing.

media

Media carrier.

Example for a video

<offer id="12344" type="artist.title" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=92347</url>
    <price>93</price>
    <currencyId>RUR</currencyId>
    <categoryId>2</categoryId>
    <delivery>true</delivery>
    <title>Muriel's Wedding</title>
    <year>1999</year>
    <media>DVD</media>
    <starring>Toni Collette, Rachel Griffiths</starring>
    <director>P. J. Hogan</director>
    <originalName>Muriel's wedding</originalName>
    <country>Australia</country>
    <description>An ugly duckling from a small town leaves her nest and sets out with her friends to search for a new life in the big and mysterious city. It's a film about dreams and reality, friendship and youth of a girl whose adventures remind us of Cinderella and Julia Robert's character in the classic Pretty Woman.</description>
</offer>

Elements describing the video in offer (required elements in the table are in bold):

Element Description

url

The URL of the product page. The URL can be up to 512 characters.

We don't recommend using spaces and Cyrillic characters in the URLs in the YML-file. This can make the file invalid.

price

The price at which this product can be purchased. The price of the product offer is rounded. The format in which it is displayed depends on the user's settings.

The specified value must not be zero.

currencyId

The product currency ID (RUR, USD, UAH, KZT). To display the product price correctly, use the identifier (for example, UAH) with the price value.

categoryId

The product category ID (an integer up to 18 characters). A product offer can belong to only one category.

delivery

Element that indicates if delivery is offered for the product.

“false” — The product can't be delivered (“Pick up”).

“true” — The product is delivered to the regions indicated in the “Shop” tab in the “Products and prices” section. The shipping price is described in the <local_delivery_cost> tag.

title

Movie Name

starring

Actors.

director

Director.

originalName

Original name.

country

Country.

year

The year of publishing.

media

Media carrier.

adult

The element is required for a product that deals with satisfaction of sexual needs or exploits interest in sex in any other way.

Tours (tour)

<offer id="12341" type="tour" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=12344</url>
    <price>958</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <delivery>false</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <worldRegion>Africa</worldRegion>
    <country>Egypt</country>
    <region>Hurgada</region>
    <days>7</days>
    <dataTour>01/01/03</dataTour>
    <dataTour>08/01/03</dataTour>
    <name>Hilton</name>
    <hotel_stars>5*****</hotel_stars>
    <room>SNG</room>
    <meal>ALL</meal>
    <included>airfare, transfer, accommodation, food, insurance</included>
    <transport>Air</transport>
    <description>Vacation in Egypt.</description>
</offer>

Elements nested in offer (required elements in the table are in bold):

Element Description

url

The URL of the product page. The URL can be up to 512 characters.

We don't recommend using spaces and Cyrillic characters in the URLs in the YML-file. This can make the file invalid.

price

The price at which this product can be purchased. The price of the product offer is rounded. The format in which it is displayed depends on the user's settings.

The specified value must not be zero.

currencyId

The product currency ID (RUR, USD, UAH, KZT). To display the product price correctly, use the identifier (for example, UAH) with the price value.

categoryId

The product category ID (an integer up to 18 characters). A product offer can belong to only one category.

delivery

Element that indicates if delivery is offered for the product.

“false” — The product can't be delivered (“Pick up”).

“true” — The product is delivered to the regions indicated in the “Shop” tab in the “Products and prices” section. The shipping price is described in the <local_delivery_cost> tag.

worldRegion

World region.

country

Country.

region

Resort or city.

days

Number of days in the tour.

dataTour

Check-in dates.

name

Hotel name (in some cases, the name of the tour).

hotel_stars

The hotel's stars.

room

Type of room (SNG, DBL, ...).

meal

Meals (All, HB, ...).

included

Whats does the tour price include?

Transport

Transport.

description

Tour description.

The description is used to replace the automatically generated snippet text in the search results. The text is replaced when it is of poor quality.

Event tickets (event-tickets)

<offer id="1234" type="event-ticket"  available="true"> 
    <url>product offer URL</url>
    <price>100000</price>
    <currencyId>RUR</currencyId>
    <categoryId>3</categoryId>
    <delivery>true</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <name>Dmitri Hvorostovsky and the National Philharmonic of Russia. Дирижер — Vladimir Spivakov.</name>
    <place>Moscow International Music Hall</place>
    <hall plan="URL of hall plan">Grand Hall<hall>
    <hall_part>rows 1-5<hall_part>
    <date>2009-12-31T19:00</date> 
    <is_premiere>0<is_premiere>
    <is_kids>0</is_kids>
    <description>Concert given by Dmitri Hvorostovsky and the National Philharmonic of Russia</description>
</offer>

Elements nested in offer (required elements in the table are in bold):

Element Description

url

The URL of the product page. The URL can be up to 512 characters.

We don't recommend using spaces and Cyrillic characters in the URLs in the YML-file. This can make the file invalid.

price

The price at which this product can be purchased. The price of the product offer is rounded. The format in which it is displayed depends on the user's settings.

The specified value must not be zero.

currencyId

The product currency ID (RUR, USD, UAH, KZT). To display the product price correctly, use the identifier (for example, UAH) with the price value.

categoryId

The product category ID (an integer up to 18 characters). A product offer can belong to only one category.

delivery

Element that indicates if delivery is offered for the product.

“false” — The product can't be delivered (“Pick up”).

“true” — The product is delivered to the regions indicated in the “Shop” tab in the “Products and prices” section. The shipping price is described in the <local_delivery_cost> tag.

name

The event name

place

Room.

hall plan

URL of the image with the hall plan.

Date

The date and time of the event. Are specified in the ISO 8601 YYYY-MM-DDThh:mm format.

is_premiere

Indicates if the event is a premiere.

is_kids

Indicates if the event is for kids.

Simplified description

This is a basic, most simple type of description.

<offer id="12346" available="true">
    <url>http://www.best.seller.ru/product_page.asp?pid=12348</url>
    <price>699.54</price>
    <currencyId>USD</currencyId>
    <categoryId>6</categoryId>
    <delivery>false</delivery>
    <local_delivery_cost>300</local_delivery_cost>
    <name>Gold wristwatch</name>
    <vendor>Longines</vendor>
    <vendorCode>A1234567B</vendorCode>
    <description>Elegant gold watch.</description>
    <country_of_origin>Switzerland</country_of_origin>
</offer>

Elements nested in offer (required elements in the table are in bold):

Element Description

url

The URL of the product page. The URL can be up to 512 characters.

We don't recommend using spaces and Cyrillic characters in the URLs in the YML-file. This can make the file invalid.

price

The price at which this product can be purchased. The price of the product offer is rounded. The format in which it is displayed depends on the user's settings.

The specified value must not be zero.

currencyId

The product currency ID (RUR, USD, UAH, KZT). To display the product price correctly, use the identifier (for example, UAH) with the price value.

categoryId

The product category ID (an integer up to 18 characters). A product offer can belong to only one category.

delivery

Element that indicates if delivery is offered for the product.

  • “false” — The product can't be delivered (“Pick up”).

  • “true” — The product is delivered to the regions indicated in the “Shop” tab in the “Products and prices” section. The shipping price is described in the local_delivery_cost> tag.

local_delivery_cost

The delivery price for the product in the region.

name

The name of the product offer.

vendor

Manufacturer.

vendorCode

Manufecturer code:

description

Product offer description

The description is used to replace the automatically generated snippet text in the search results. The text is replaced when it is of poor quality.

country_of_origin

The element is used to indicate the country of origin of the product. The list of countries that can be specified in this element is available at: http://partner.market.yandex.ru/pages/help/Countries.pdf.

adult

The element is required for a product that deals with satisfaction of sexual needs or exploits interest in sex in any other way.