Список элементов любого вида, например, «10 лучших фильмов про любовь» или «100 лучших песен для вечеринок». Не путать со списками HTML, которые часто используются только для форматирования.

Каноническая ссылка: https://schema.org/ItemList

Свойства ItemList:

Свойство Ожидаемый тип Описание
itemListElement* ListItem / Текст / Thing

Для значений itemListElement вы можете использовать простые строки (например, «Питер», «Пол», «Мэри»), существующие объекты или использовать ListItem.

Текстовые значения лучше всего, если элементы в списке представляют собой простые строки. Существующие объекты лучше всего подходят для простого неупорядоченного списка существующих вещей в ваших данных. ListItem используется с упорядоченными списками, когда вы хотите предоставить дополнительный контекст об элементе в этом списке или когда один и тот же элемент может находиться в разных местах в разных списках.
itemListOrder ItemListOrderType / Текст Тип упорядочивания (например, По возрастанию, По убыванию, Неупорядоченный).
numberOfItems Число Количество элементов в списке. Обратите внимание, что иногда количество может описывать не все видимые элементы в списке (например, многостраничная разбивка на страницы); в таких случаях numberOfItems будет для всего списка.

Свойства, унаследованные от Thing:

Свойство Ожидаемый тип Описание
additionalType URL Дополнительный тип для элемента, обычно используемый для добавления более конкретных типов из внешних словарей в синтаксис микроданных. Это связь между чем-то и классом, в котором находится Thing
alternateName Текст Альтернативное имя
description Текст Описание объекта
disambiguatingDescription Текст Более конкретное описание, полезное для избежания неоднозначности
identifier PropertyValue Идентификатор для любого типа контента
image URL Изображение, которое может быть или ссылкой или полностью описанной сущностью
mainEntityOfPage URL Указывает страницу, для которой данный объект является основной описываемой сущностью.
name Текст Имя объекта
potentialAction Action Обозначает потенциальное свойство Action, которое описывает идеализированное действие, в котором эта Thing будет играть роль «объекта».
sameAs URL URL-адрес справочной веб-страницы, указывающий на идентичность элемента.
subjectOf CreativeWork Указывает тип контента, являющимся субъектом данного
url URL Адрес объекта

* - свойства, рекоммендуемые Google для обязательного использования.

Более специфические типы для Article:

Пример разметки с помощью микроданных:

<div itemscope itemtype="https://schema.org/ItemList">
  <link itemprop="url" href="http://it-shop.com"><span itemprop="numberOfItems">315</span>
  <div itemprop="itemListElement" itemscope itemtype="https://schema.org/Product">
    <img alt="iphone 12 black" itemprop="image" src="http://it-shop.com/img23.jpg">
    <a itemprop="url" href="http://it-shop.com/iphone12-64-gb-black/"><span itemprop="name">Apple iPhone 12 64Gb Black</span></a>
    <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
      <span itemprop="price">1012$</span>
    </div>
  </div>
  <div itemprop="itemListElement" itemscope itemtype="https://schema.org/Product">
    <img alt="iphone 12 purple" itemprop="image" src="http://it-shop.com/img24.jpg">
    <a itemprop="url" href="http://it-shop.com/iphone12-64-gb-purple/"><span itemprop="name">Apple iPhone 12 64Gb Purple</span></a>
    <div itemprop="offers" itemscope itemtype="https://schema.org/Offer">
      <span itemprop="price">1014$</span>
    </div>
  </div>
</div>

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

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "url": "http://it-shop.com",
  "numberOfItems": "315",
  "itemListElement": [
    {
      "@type": "Product",
      "image": "http://http://it-shop.com/img23.jpg",
      "url": "http://it-shop.com/iphone12-64-gb-black/",
      "name": "Apple iPhone 12 64Gb Black",
      "offers": {
        "@type": "Offer",
        "price": "1012$"
      }
    },
   {
      "@type": "Product",
      "image": "http://http://it-shop.com/img24.jpg",
      "url": "http://it-shop.com/iphone12-64-gb-purple/",
      "name": "Apple iPhone 12 64Gb Purple",
      "offers": {
        "@type": "Offer",
        "price": "1014$"
      }
    }
  ]
}
</script>