JSON-LD

Как работает

JSON-LD ставится в отдельный <script type="application/ld+json"> в блоке <head> или прямо в <body> страницы — Google и Яндекс парсят его без выполнения JavaScript. Один блок описывает одну сущность: товар, статью, организацию, крошки навигации.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Электрический чайник Bosch TWK 7203",
  "sku": "TWK7203",
  "offers": {
    "@type": "Offer",
    "price": "4890",
    "priceCurrency": "RUB",
    "availability": "https://schema.org/InStock"
  }
}
</script>

Ключевое поле @context указывает словарь — обычно https://schema.org. Поле @type — тип сущности из этого словаря: Product, Article, LocalBusiness, BreadcrumbList, FAQPage. Остальные поля — свойства выбранного типа: name, description, image, offers и десятки других.

JSON-LD — не единственный способ разметить данные, но с 2015 года Google в документации Search Central явно рекомендует его вместо Microdata и RDFa: JSON-LD не смешивается с HTML-разметкой, легче поддерживается, и его удобнее генерировать шаблонизатором на бэкенде.

Почему важно для SEO

Микроразметка через JSON-LD напрямую не влияет на позицию в выдаче, но открывает доступ к rich results — расширенным сниппетам: звёзды рейтинга, цена и наличие для товаров, время приготовления для рецептов, вопросы и ответы для FAQ. Такие сниппеты забирают заметно больше места в SERP и повышают CTR — по данным Google до 30% на конкурентных запросах.

Яндекс использует JSON-LD аналогично: сниппет-карточка товара с ценой и наличием, расширенный результат для рецептов, звёзды рейтинга для отзывов. Валидатор микроразметки Яндекса поддерживает JSON-LD наравне с Microdata.

Частые ошибки

• В JSON-LD указаны свойства, которых нет на видимой странице — Google трактует это как обман и лишает страницу rich results.
• Синтаксическая ошибка (лишняя запятая, незакрытая кавычка) — весь блок игнорируется.
• Один блок описывает несколько сущностей без массива @graph — валидатор находит только первую.
• Разметка Product без обязательных полей (name, offers, image) — карточка не появится в поиске.
• BreadcrumbList не совпадает с реальным путём в UI — Google предпочтёт свой расчёт крошек.
• @type: FAQPage на странице, где нет видимых вопросов и ответов — с августа 2023 Google перестал показывать rich results для таких страниц.

Как проверить

Google Rich Results Test (search.google.com/test/rich-results) — самый быстрый способ проверить, какие расширенные сниппеты Google найдёт на конкретной странице. Валидатор микроразметки Яндекса (webmaster.yandex.ru/tools/microtest) делает то же самое для Яндекса. В Google Search Console раздел «Улучшения» отдельно показывает страницы с распознанной разметкой и ошибками.

SEO Crawler при обходе сайта извлекает все блоки JSON-LD, проверяет валидность JSON, наличие обязательных полей для каждого @type и совпадение разметки с видимым содержимым страницы. В отчёте это блок «Микроразметка» — с указанием типов, страниц с ошибками и покрытия по разделам сайта.

Вывод

JSON-LD — предпочтительный формат микроразметки, потому что живёт отдельно от HTML и не мешает вёрстке. Валидируйте каждый новый шаблон через Rich Results Test и Валидатор Яндекса, не размечайте контент, которого нет на странице, и следите за отчётом «Улучшения» в Search Console — там появятся первые ошибки, если что-то поедет после релиза.