Field descriptions

FieldDescriptionRequired

id

Product ID. May contain numbers, Latin letters, hyphens and underscores. Maximum length: 80 characters. Must be unique for each product.

Required

name

Full product name in Russian.

Follow this format: what (type of product) + who (manufacturer or brand) + product (name and model) + key characteristics. Examples:

  • Product type — smartphone, pocket flashlight.

  • Brand — Xiaomi, Samsung.

  • Model — iPhone X Mi Smart Band.

  • The key parameters are steel casing and disappearing ink.

Parameters that vary within a single product should be specified in param. For example: color, size, quantity in each package, etc.

If you use the name element, you must fill in the description element. If you don't usе the name and description elements, you must use the english-description element.

Optional if the following is specified: english-description

english-name

Full product name in English. Follow this format: what (type of product) + who (manufacturer or brand) + product (name and model) + key characteristics.

Examples:

  • Product type — smartphone, headphones.

  • Brand — Xiaomi, Samsung.

  • Model — iPhone X Mi Smart Band.

  • Key parameters — steel case.

Parameters that vary within a single product should be specified in param. For example: color, size, quantity in each package, etc.

Required

category

Attention. This element is used in CSV and XLS formats.
Product category. How to specify it:
Stores from China

Specify the path to the category in the Yandex.Market format

category 1\\category 2\\...\\final category
Category names should be in English. They must be taken from the file: Download

For example:

Beauty & Health\\Hair Care & Styling\\Styling Products\\Braid Maintenance
Other stores
Enter the category name in English or Russian. For example:
Braid Maintenance

Required

categories-type
Attention. This element is used in CSV and XLS formats.
Enter the number 1 in the field if you used a category name from the file above (from the category description).
Optional

categoryId

Attention. This element is used in the YML format.

The ID of the product category.

All categories (names and IDs) must be listed in the categories element.

Required

price

Current price of the product.

Required

oldprice

Old price for the product. Must be higher than the current price. The app automatically calculates the difference between the old and current prices and shows users the discount.

Optional

currencyId

Product price currency: RUR, USD, EUR, UAH, KZT, BYN. The price and currency must match. For example, with USD the price should be specified in dollars, not rubles.

Required

weight

Item weight in kilograms including packaging. You can specify up to three decimal places (for example, 1.001). The decimal separator is a dot.

Required

cargo-type

Cargo classification code.

View codes
CodeDescription
0Unknown type
10Documents and securities
50Art objects
80Valuables and precious metals
100Consumer goods
200Appliances and electronics
220Batteries
230With battery
300Heavy and oversized cargo
400Dangerous cargo
420Weapons and explosives
440Cosmetics and perfumes
450Aerosols and gas cylinders
460Odorous cargo
470Powders
480Chemicals
500Wet cargo
700Perishables
750Foodstuffs
800Animals
900Medications

Required

picture

URL link to product image. If there are several images:

in XLS or CSV

In one picture field you can enter up to 10 links to images, separated by commas.

in YML
Specify each image link in a separate picture element. You can specify up to 10 picture elements.

The product parameters on the first image must match the parameters in param. For example, if param specifies green color, the first image should show the product in green.

The maximum URL length is 512 characters. Acceptable protocols: HTTP, HTTPS. Formats: JPEG, PNG, GIF. The maximum size is 3,500 pixels on the longest side. The minimum size is 600 pixels on either side. Acceptable backgrounds: white, transparent.

Required

dimensions

Product dimensions (length, width, height) including packaging. Specify dimensions in centimeters.

Format: three positive numbers with accuracy of 0.001, using a dot as the decimal separator. The numbers must be separated by the slash symbol “/” without spaces. For example:

50.5/25/75.2

Required

description

Product description in Russian. Maximum text length is 3,000 characters (including punctuation marks). The following are not allowed in the description:

  • Phone numbers, email addresses, postal addresses, ICQ numbers, instant messenger usernames, or any URL links.
  • The words “discount”, “sale”, “cheap”, “gift” (except for gift categories), “gratis”, “promotion”, “special price”, “free”, “new”, “equivalent”, “order”, “hit”.
  • Terms of sale of the product, such as information about promotions or prepayment.
  • Region where the product is sold.
  • Information about different product modifications (for example, you cannot write “variations available”). For each modification, you need to create a separate line in the CSV or XLS file, or separate offer in YML.

You can use the XHTML tags <h3>...</h3>, <ul><li>...</li></ul>, <p>...</p>, <img>...</img>, <table>...</table>, and <br/>, provided that:

  • They are enclosed in the CDATA section in the format: <![CDATA[ Text with XHTML markup ]]>.

  • They conform to the general rules of the XHTML standard.

If you use the description element, you must fill in the name element. If you don't usе the name and description elements, you must use the english-description element.

Optional if the following is specified: english-description

english-description

Product description in English. The requirements are the same as the requirements for description.

Optional if the following are specified: description and name

vendor

Name of manufacturer or brand.

Optional

hs-code

Customs code (Commodity Nomenclature of Foreign Economic Activity).

Optional

param

All important characteristics of the product in Russian or English — color, size, volume, material, age, gender, etc.

In YML, there can be multiple param fields. The Excel or CSV file can only contain one param.

Detailed element description.

Required for clothing and if group-id is specified. Optional in other cases.

group-id

ID for grouping products (when multiple products are variations of the same model). The value group-id must be the same for all products from the same group (for instance, purses of the same model in different colors).

The value can contain numbers, Latin letters (lowercase and uppercase), hyphens and underscores.

Optional

main-picture

URL link to a picture of the product group. For example, an image that shows purses of the same model in all available colors.

Optional

adult

The product is of a sexual nature or pertains to sexual interest in any way. Possible values — true, false.

Optional