Promo code discount

Specify the promo code text and the discount amount in the price list.

Note. Yandex.Market verifies that the item was sold at the old price or higher before the promotion:
  • For 60 days in the “Clothing, shoes and accessories” category.
  • For 30 days in all other categories.

If this is not the case, the offer is displayed without the promotion.

  1. Structure
  2. Attributes and elements
  3. Examples


   <promo id="promo ID" type="promo code">
      <start-date>promo start date</start-date>
      <end-date>promo end date</end-date>
      <url>promo on the store's site</url>
      <promo-code>promo code</promo-code>
      <discount unit="discount as a percent or currency amount" currency="currency">discount amount</discount>
        <product offer-id="offer ID participating in promo"/>
        <product category-id="category ID participating in promo"/>

Attributes and elements

Element/attribute Description Required
Attribute id ID of the promotion. Must be unique for the entire price list. It may contain only numbers and Latin letters. The maximum length of id is 20 characters.
Attention. Each offer can only participate in one promotion.
Attribute type

Type of promo — promo code.


Date and time when the promo starts. Allowed formats: YYYY-MM-DD hh:mm:ss or YYYY-MM-DD.

The date and time are the same for all time zones.


The store sells products in Moscow and delivers to Yekaterinburg; date and time of the promo: from 10 AM on March 8 to 10 AM on March 9.

For users in Moscow, the promo will run from 10 AM on March 8 to 10 AM on March 9 (Moscow time).

For users from Yekaterinburg, it will be from 10 AM on March 8 to 10 AM on March 9 in the Ural time zone.


Date and time the promotion ends. Allowed formats: YYYY-MM-DD hh:mm:ss or YYYY-MM-DD.

The date and time are the same for all time zones (see the example above).


Brief description of the promo in Russian. Maximum of 500 characters. You can use XHTML markup, but only as a CDATA block of character data.


Link to the promotion description on the store's website.


The text of the promo code. Maximum length: 20 characters.


The discount amount as a percentage of the price or in a currency. The discount type is specified in the attributes:

  • unit="percent" — The discount as a percent. Acceptable values: 5–95 percent.
  • unit="currency" currency="RUR" — The discount in the currency. Acceptable values: multiples of 100.

This element is in purchase.


Information about items participating in the promotion.



Items and/or categories that the promotion applies to. Attributes:

  • offer-id — Offer ID.
  • category-id — Category ID.

Each product element corresponds to a single item or category. A purchase element may contain multiple product elements.



Discount of 10% of the item price:

<promo id="Promo10" type="promo code">
  <start-date>2018-02-01 00:00:00</start-date>
  <end-date>2018-03-01 00:00:00</end-date>
  <description>Скидка 10% по уникальному промокоду!</description>
  <discount unit="percent">10</discount>
    <product offer-id="55"/>
    <product offer-id="66"/>
    <product category-id="1"/>
    <product category-id="2"/>

Discount of 300 rubles:

<promo id="Promo300" type="promo code">
  <start-date>2018-02-01 00:00:00</start-date>
  <end-date>2018-03-01 00:00:00</end-date>
  <description>Скидка 300 рублей по уникальному промокоду!</description>
  <discount unit="currency" currency="RUR">300</discount>
    <product offer-id="77"/>
    <product offer-id="88"/>