---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.4
  - property: title
    content: Семантическая разметка страниц с товарами
  - property: description
    content: В Справке Яндекс Товаров описано, как размечать данные с помощью семантической разметки, чтобы при обходе роботом они имели максимальный приоритет по сравнению с данными из других источников.
  - property: og:image
    content: https://avatars.mds.yandex.net/get-lpc/1635340/efb10d62-32d0-4863-a8e0-8cc059de4713/orig
alternate:
  - https://yandex.ru/support/merchants/ru/microdata.md
  - href: ru/microdata.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/merchants/ru/llms.txt


# Семантическая разметка страниц с товарами

Микроразметка (семантическая разметка) — это семантический словарь стандартизованных тегов и атрибутов, которые внедряют в HTML-код страницы, чтобы поисковым системам проще было понимать ее содержание. Она буквально показывает поисковым системам, какие элементы информации содержатся на странице: цена, наличие товара и т.д.

Разметка может сделать ваш сайт более заметным в Поиске Яндекса и таким образом привлечь больше посетителей, принадлежащих целевой аудитории. Однако, напрямую семантическая разметка не влияет на ранжирование.

Мы рекомендуем использовать разметку [Schema.org](https://schema.org/). Это один из словарей семантической разметки данных, которые совместно анонсировали Google, Bing и Yahoo еще в 2011 году.

В частности товарные страницы мы рекомендуем размечать по схеме [Product](https://schema.org/Product) со значением свойства [offers](https://schema.org/offers), соответствующим схеме [Offer](https://schema.org/Offer) или [AggregateOffer](https://schema.org/AggregateOffer).

## Синтаксис микроразметки {#sint}

Помимо самого словаря важно учитывать формат кода разметки. Это способ передать данные из словаря. Мы рекомендуем использовать:

{% list tabs %}

- Микроданные

  Для корректной микроразметки товаров важно:
  
  * соблюдать структуру схемы ([Product](https://schema.org/Product) со значением свойства [offers](https://schema.org/offers), соответствующим схеме [Offer](https://schema.org/Offer) или [AggregateOffer](https://schema.org/AggregateOffer));
  
  * обеспечивать наличие обязательных полей:

     #|
     || **Поле** | **Описание** | **Обязательное поле** ||
     || Свойства [Product](https://schema.org/Product) | > | > ||
     || `name` ([Text](https://schema.org/Text)) | Название товара | Да ||
     || `description` ([Text](https://schema.org/Text)) | Описание товара | Нет ||
     || `brand` ([Text](https://schema.org/Text)) | Информация о продавце/производителе | Да ||
     || `image` ([URL](https://schema.org/URL)) | Картинка товара. Не является объектом типа `ImageObject`. | Да ||
     || Свойства [Offer](https://schema.org/Offer) или [AggregateOffer](https://schema.org/AggregateOffer) | > | > ||
     || `availability` ([URL](https://schema.org/URL)) | Доступность товара для заказа | Да ||
     || `price` ([Text](https://schema.org/Text) или [Number](https://schema.org/Number)) или `lowPrice` ([Text](https://schema.org/Text) или [Number](https://schema.org/Number)) | Цена товара | Да ||
     || `priceCurrency` ([Text](https://schema.org/Text)) |  Валюта | Да ||
     |#

  Пример корректной микроразметки:

  ```html
  <div itemscope itemtype="https://schema.org/Product">
    <!--В поле name указывается наименование товара.-->
    <span itemprop="name">Товар</span>
    <!--В поле description указывается описание товара.-->
    <span itemprop="description">Описание товара</span>
    <!--В поле image указывается ссылка на картинку товара.-->
    <img src="http://www.example.com/image.jpg" itemprop="image">
    <!--В поле brand указывается информация о продавце/производителе.-->
    <span itemprop="brand">Бренд товара</span>
    <!--Указывается схема Offer.-->
    <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
       <!--В поле price указывается цена товара.-->
       <meta itemprop="price" content="7150.00">
       <!--В поле priceCurrency указывается валюта.-->
       <meta itemprop="priceCurrency" content="RUB">
       <!--В поле availability указывается информация о доступности товара для заказа.-->
       <link itemprop="availability" href="http://schema.org/InStock">
    </div>
  </div>
  ```

- JSON-LD

  [JSON-LD](http://json-ld.org/) — это формат описания контента с помощью объектов словаря [связанных данных](https://ru.wikipedia.org/wiki/Linked_data) (Linked Data, LD).

  {% cut "Подробнее о формате" %}

  Данные в формате [JSON-LD](http://json-ld.org/) описываются набором разделенных запятыми пар «ключ-значение». Формат предусматривает зарезервированные ключи, с помощью которых можно определять контекст описания или связывать объекты различным образом. Например, `@context` определяет словарь объектов, а `@type` — тип описываемой сущности. Полный список зарезервированных ключей приведен в [официальной документации JSON-LD](http://www.w3.org/TR/json-ld/#syntax-tokens-and-keywords).

  Все ключи и значения в формате JSON-LD чувствительны к регистру.

  Основные понятия:

  * Объект JSON — набор пар «ключ-значение» (0 или больше), разделенных запятыми. Сущность описывается в фигурных скобках {} в теге `script` с атрибутом `type="application/ld+json"` или `type="ld+json"`. В объектах JSON-LD имена ключей в одном и том же объекте не должны повторяться.

  * Массив — набор значений, разделенных запятыми. Описывается в квадратных скобках. Массив не считается упорядоченным, если это не указано специально.

  * Строка — набор символов `Unicode`, заключенных в двойные кавычки. При необходимости символы можно указывать с помощью обратных слэшей (\).

  * Число — используется как и в большинстве языков программирования. Но при этом не поддерживаются восьмеричное и шестнадцатеричное представления. Также запрещены нули в начале числа.

  * `true` и `false` — бинарные значения, которые можно использовать для ключей только с двумя вариантами значений (например, поддерживается ли какая-то функция в товаре или нет).

  * `null` — отсутствующее значение. Обычно используется для очистки данных. Если `null` указан как значение ключа `@value`, `@list` или `@set` внутри JSON-объекта, этот объект полностью игнорируется.

  {% endcut %}

  Пример микроразметки Product в формате JSON-LD:

  ```JSON
  {
    <!--Для разметки используется словарь Schema.org-->
    "@context": "http://schema.org/",
    <!--Описывается сущность типа Product-->      
    "@type": "Product",                         
    "name": "Название товара",
    "image": "https://example.com/photo.jpg",
    "description": "Описание товара",
    "sku": "SKU",
    "brand": {
      "@type": "Brand",
      "name": "Бренд товара"
    },
    "offers": {
      "@type": "Offer",
      "priceCurrency": "RUB",
      "price": "1000.00",
      "availability": "http://schema.org/InStock"
    }
  }
  ```

  Разметку можно добавить на сайт автоматически — например, с помощью плагинов. Перед использованием убедитесь, что выбранный плагин позволяет передать в код страницы все нужные элементы разметки.
  
  Если требуется доработка плагина, обратитесь к его разработчику или другому специалисту с навыками разработки.

{% endlist %}

Вы можете [проверить качество микроразметки](https://yandex.ru/support/merchants/ru/microdata-online.md) в личном кабинете Яндекс Товаров.<!-- По наличию данных в **обязательных** полях оценивается [качество микроразметки](https://yandex.ru/support/merchants/ru/microdata-online.md).-->


## Как внедрить {#implement}

Для популярных CMS могут быть разработаны плагины для внедрения микроразметки. Проверить, есть ли плагин для вашего сайта, можно в CMS или в описании платформы, на которой разработан сайт.

<!-- source: ru/_includes/support-button.md -->
<br>

<a href="../troubleshooting.html">
  <span class="button">Написать в службу поддержки</span>
</a>



<!-- endsource: ru/_includes/support-button.md -->
