Что описывает ItemList
ItemList — упорядоченный или неупорядоченный список объектов: статей в подборке, товаров в категории, позиций в рейтинге «Топ-10». Каждый элемент списка — ListItem с номером позиции и ссылкой на страницу элемента.
Ключевые свойства
| Тип | Свойство | Что указывать |
|---|---|---|
ItemList | itemListElement | Массив элементов списка |
ItemList | itemListOrder | Порядок: по возрастанию, по убыванию или без порядка |
ItemList | numberOfItems | Число элементов |
ListItem | position | Номер позиции, начиная с единицы |
ListItem | url | Адрес страницы элемента |
ListItem | name | Название элемента |
Пример для страницы категории
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "ItemList",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "url": "https://example.ru/divany/alfa/", "name": "Диван «Альфа»" },
{ "@type": "ListItem", "position": 2, "url": "https://example.ru/divany/beta/", "name": "Диван «Бета»" },
{ "@type": "ListItem", "position": 3, "url": "https://example.ru/divany/gamma/", "name": "Диван «Гамма»" }
]
}
</script>В этом примере каждый элемент только ссылается на страницу товара. Подробные данные о цене и наличии остаются в разметке самих страниц товаров.
Правила использования
- Список в разметке должен присутствовать на странице и быть виден пользователю.
- Порядок и нумерация в разметке совпадают с порядком на странице.
- Каждый элемент ведёт на собственную страницу; это условие для показа карусели у некоторых типов содержимого.
- Не описывайте элементы списка как самостоятельные товары со своими ценами на странице категории — для этого есть страницы товаров.
Связь с другими типами: разметку самих товаров описывает статья про Product, а различия между единичным и множественным предложением — статья про Offer и AggregateOffer.
Что размечать на каких страницах
| Страница | Что использовать |
|---|---|
| Категория со списком товаров | ItemList со ссылками на страницы товаров |
| Карточка отдельного товара | Product |
| Подборка статей | ItemList со ссылками на статьи |
| Рейтинг «Топ-10» | ItemList с нумерацией позиций |
| Страница пагинации | Отдельный ItemList только для видимых на ней элементов |
Частые ошибки
- В список включены элементы, которых нет на странице.
- Нумерация в разметке не совпадает с порядком на странице.
- Элемент списка не ведёт на собственную страницу.
- Один список описывает сразу несколько страниц пагинации.
Если список формируется программно, проверяйте, что при сортировке или фильтрации разметка меняется вместе со страницей, а не остаётся прежней.
Список и внутренняя перелинковка
Помимо разметки, список на странице — это набор внутренних ссылок. Убедитесь, что элементы списка являются обычными ссылками с осмысленным текстом, а не картинками без подписей: так и пользователю, и роботу проще перейти к нужной странице. Об общих принципах — в статье про внутренние ссылки как инструмент индексации.
Частые вопросы
Какой тип использовать для страницы категории?
ItemList со списком ссылок на страницы товаров, а не Product и не Offer, которые описывают отдельный товар.
Обязательно ли указывать порядок элементов?
Нумерация позиций через свойство position обязательна для ListItem, а порядок должен совпадать с порядком на странице.
Нужно ли размечать пагинацию в ItemList?
Каждую страницу пагинации описывают отдельным списком тех элементов, которые на ней действительно видны.
Готовый адрес можно собрать прямо сейчас: откройте генератор ЧПУ — он транслитерирует фразу по таблице Яндекса, уберёт служебные слова и покажет длину адреса.