Как сделать микроразметку JSON-LD

Микроразметка JSON-LD — блок кода, в котором страница сама рассказывает поисковику, что на ней: компания с адресом и телефоном, товар с ценой, вопросы и ответы, путь по разделам сайта. Из этих данных Яндекс и Google строят расширенные сниппеты и карточки, а нейросети — ответы со ссылкой на сайт. Разберём, как сделать JSON-LD для самых нужных типов, куда вставить код и как не ошибиться.

Разметку Schema.org можно записать тремя способами: JSON-LD, микроданные (атрибуты itemprop в вёрстке) и RDFa. Подробно о синтаксисах и типах мы писали в статье про микроразметку Schema.org. На практике чаще всего выбирают JSON-LD:

• Google прямо рекомендует этот формат, Яндекс его тоже понимает.
• Разметка лежит одним блоком и не смешивается с вёрсткой — дизайнер может переделать шаблон, и разметка не сломается.
• Блок легко сгенерировать в CMS из полей товара или статьи и легко проверить.

Главное правило для любого формата: в разметке только то, что видно на странице. Цена в JSON-LD должна совпадать с ценой на карточке, вопросы FAQ — быть на странице текстом, рейтинг — строиться по реальным отзывам.

Для компании без офиса для посетителей подойдёт тип Organization. Если есть точка, куда приходят клиенты, — LocalBusiness или его уточнение: Store для магазина, Restaurant для кафе, AutoRepair для автосервиса, MedicalBusiness для клиники. Для местного бизнеса важны адрес, телефон и часы работы:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "LocalBusiness",
  "name": "Окна Плюс",
  "url": "https://example.ru/",
  "logo": "https://example.ru/logo.png",
  "telephone": "+7 495 123-45-67",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "ул. Ленина, 1",
    "addressLocality": "Москва",
    "addressCountry": "RU"
  },
  "openingHours": ["Mo-Fr 09:00-18:00", "Sa 10:00-16:00"],
  "sameAs": ["https://vk.com/example", "https://t.me/example"]
}
</script>

В sameAs перечисляют официальные страницы компании: соцсети, карточки на картах, профиль в справочниках. Так поисковики и нейросети связывают сайт с компанией.

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

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type": "ListItem", "position": 1, "name": "Главная", "item": "https://example.ru/"},
    {"@type": "ListItem", "position": 2, "name": "Окна", "item": "https://example.ru/okna/"},
    {"@type": "ListItem", "position": 3, "name": "Окна Rehau"}
  ]
}

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

Для товарного сниппета Google нужно название и хотя бы одно из трёх: предложение с ценой, отзыв или рейтинг. Без фото расширенного сниппета тоже не будет:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Пластиковое окно Rehau 1300×1400",
  "image": "https://example.ru/img/okno.jpg",
  "brand": {"@type": "Brand", "name": "Rehau"},
  "offers": {
    "@type": "Offer",
    "price": "15900",
    "priceCurrency": "RUB",
    "availability": "https://schema.org/InStock"
  }
}

Цена пишется числом без пробелов и знака рубля, копейки — через точку. Валюта — трёхбуквенным кодом. Рейтинг (aggregateRating) добавляйте, только если на странице есть настоящие отзывы: за выдуманные оценки поисковики снимают расширенные сниппеты.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "Сколько стоит установка окна?",
    "acceptedAnswer": {"@type": "Answer", "text": "От 3 000 ₽ в зависимости от размера и этажа."}
  }]
}

С 2023 года Google показывает FAQ-сниппеты в основном сайтам госорганов и медицины. Разметку всё равно стоит ставить: она помогает поисковикам и нейросетям понять, на какие вопросы отвечает страница. Вопросы и ответы должны быть на странице текстом, а не только в коде. Собрать вопросы по тексту страницы поможет генератор FAQ.

• Сайт на своём движке. В шаблон страницы — в <head> или в конец <body>. Для товаров и статей поля подставляет шаблон.
• WordPress. SEO-плагины выводят Organization, Article и крошки сами. Свою разметку можно вставить через блок «HTML» или плагин для вставки кода.
• Тильда, конструкторы. В настройках страницы есть поле для HTML-кода в <head>, на страницу можно добавить блок с HTML.
• Битрикс. В шаблон компонента или через настройки SEO-модуля.

Одна страница может содержать несколько блоков JSON-LD: например, крошки, товар и организацию. Главное — не дублировать один и тот же тип с разными данными.

Писать JSON вручную долго, а одна пропущенная запятая ломает весь блок. В генераторе микроразметки JSON-LD код собирается по форме:

1. Выберите тип: организация, FAQ, хлебные крошки, товар или статья. Для организации есть виды местного бизнеса — магазин, услуги, медицина, кафе, автосервис, салон красоты.
2. Заполните поля. Обязательные отмечены звёздочкой, под формой видно, чего не хватает: например, адреса для местного бизнеса или фото товара.
3. Для FAQ и крошек добавляйте строки кнопкой — вопросы с ответами или уровни цепочки.
4. Скопируйте готовый код и вставьте его на страницу.
5. После публикации проверьте страницу валидатором микроразметки: он найдёт ошибки JSON и пропущенные свойства.

Генератор работает в браузере: данные никуда не отправляются, а заполненные поля запоминаются, чтобы можно было вернуться и поправить разметку. Пустые поля в код не попадают, а символ «<» в текстах экранируется, чтобы ответ с кодом не сломал страницу.

• Данных из разметки нет на странице. Цена, вопросы или рейтинг только в коде — нарушение правил поисковиков.
• Цена с пробелами и знаком валюты. «15 900 ₽» вместо «15900» — поисковик не поймёт цену.
• Относительные адреса. В url, logo и image нужны полные адреса с https://.
• Ошибка в JSON. Лишняя или пропущенная запятая, кавычки-«ёлочки» вместо прямых — и блок не читается целиком.
• Разные данные в разных местах. Телефон в разметке не совпадает с телефоном на сайте и в карточке на картах.

Что лучше для микроразметки — JSON-LD или микроданные?

Для нового сайта — JSON-LD: его рекомендует Google, понимает Яндекс, и разметка не зависит от вёрстки. Микроданные имеет смысл оставить, если они уже встроены в шаблон и работают без ошибок.

Когда появится расширенный сниппет после добавления разметки?

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

Можно ли поставить несколько типов разметки на одну страницу?

Да. На карточке товара обычно есть Product и BreadcrumbList, на главной — Organization. Каждый тип можно вставить отдельным блоком.

Нужна ли разметка организации на каждой странице?

Достаточно главной или страницы контактов. На остальных страницах важнее разметка их содержимого: товара, статьи, крошек.

Как проверить, что разметка работает?

Вставьте адрес страницы в валидатор микроразметки: он покажет найденные типы, ошибки JSON и пропущенные обязательные свойства.