Что такое JSON-LD

JSON-LD — формат микроразметки, в котором данные о странице (что это за организация, товар, статья, вопросы и ответы) записываются отдельным блоком кода, а не встраиваются в HTML-теги текста. Словарь при этом обычно тот же — Schema.org.

Как выглядит

Блок размещается в <head> или в любом месте страницы:

<script type="application/ld+json">
{"@context": "https://schema.org", "@type": "LocalBusiness",
 "name": "Автосервис «Мотор»", "telephone": "+7 900 000-00-00",
 "address": "Калининград, ул. Примерная, 1"}
</script>

Посетитель этот блок не видит, его читают поисковые роботы.

Чем удобнее других форматов

Есть ещё Microdata и RDFa — там атрибуты расставляют прямо в тегах с текстом. Это сложно поддерживать: правка дизайна легко ломает разметку. JSON-LD живёт отдельно, его проще сгенерировать в шаблоне CMS, проверить и обновить. Google рекомендует именно этот формат, Яндекс его тоже понимает.

Что можно разметить

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

Главные правила

• данные в разметке должны совпадать с тем, что видно на странице;
• нельзя размечать то, чего на странице нет — например, выдуманный рейтинг;
• обязательные поля для выбранного типа должны быть заполнены.

Пример

Стоматология добавила на страницы услуг JSON-LD с типом Dentist, адресом, телефоном и часами работы, а на страницу с вопросами — разметку FAQ. Ошибок валидатор не нашёл, а поисковики получили точные данные о клинике без разбора вёрстки.

Частые вопросы

Как проверить JSON-LD?

В валидаторе микроразметки Яндекс Вебмастера и в инструменте проверки расширенных результатов Google. Оба покажут найденные объекты и ошибки в полях.

Гарантирует ли разметка красивый сниппет?

Нет. Разметка — подсказка, а решение о расширенном сниппете поисковик принимает сам. Но без разметки шансов на такой сниппет заметно меньше.