Проверка микроразметки Schema.org: валидаторы, пошаговая инструкция и частые ошибки
Проверка микроразметки отвечает на два разных вопроса. Первый: корректна ли разметка как schema.org — валидный JSON, существующие типы и свойства, значения в правильном формате? Второй: выполняет ли она требования Google для конкретного расширенного результата — сниппета товара, звёзд рейтинга, карточки мероприятия? На первый вопрос отвечает Schema Markup Validator на validator.schema.org, на второй — проверка расширенных результатов Google (Rich Results Test), а наш валидатор микроразметки проверяет синтаксис, словарь schema.org и обязательные поля Google в одном отчёте. После публикации отчёты о расширенных результатах в Search Console показывают, что Google на самом деле нашёл по всему сайту.
Чем проверять микроразметку сейчас
| Инструмент | Что проверяет | JavaScript | Когда нужен |
|---|---|---|---|
| Rich Results Test (Google) | Только типы, для которых у Google есть расширенные результаты, с обязательными и рекомендуемыми полями по правилам Google. Принимает URL или код, JSON-LD, Microdata и RDFa. По умолчанию проверяет как смартфон, можно выбрать компьютер. | Да — смотрит отрисованную страницу | «Примет ли Google это для расширенного результата?» |
| Schema Markup Validator (schema.org) | Любые типы и свойства schema.org в JSON-LD, Microdata и RDFa. Правил Google нет. | В документации не указано — при сомнениях вставляйте код | Типы, которые Google не использует; общая корректность |
| Валидатор PromoPilot | Синтаксис JSON со строкой и столбцом, словарь schema.org, обязательные и рекомендуемые поля Google для 11 семейств типов, связи @graph и @id, дубли сущностей | Нет — читает HTML, который отдаёт сервер | Понять, почему блок сломан, и получить исправленную копию |
| Отчёты Search Console | Что Googlebot нашёл на сайте: валидные и невалидные объекты, проблемы в динамике | Да, при индексации | Контроль после выкладки |
На практике нужны два инструмента: валидатор, пока вы пишете разметку, и Rich Results Test или Search Console — для стороны Google.
Как проверить микроразметку: пошагово
- Узнайте, что вообще есть на странице. Откройте исходный код (Ctrl+U) и найдите
application/ld+json(JSON-LD),itemscope(Microdata) иtypeof(RDFa). Если плагин обещает разметку, а в исходном коде её нет — скорее всего, её добавляет JavaScript (об этом ниже). - Сначала синтаксис. Одна лишняя запятая или «типографская» кавычка — и весь блок JSON-LD невалиден, поисковик пропускает его целиком. Валидатор покажет строку и столбец ошибки.
- Затем словарь. Типы пишутся с большой буквы (
Product), свойства — в camelCase (datePublished), свойство должно относиться к своему типу. Значения перечислений — полные URL (https://schema.org/InStock), даты и длительности — в ISO 8601. - Требования Google для нужной функции. Прогоните URL через Rich Results Test. Ошибка — объект не может получить этот расширенный результат. Предупреждение — не хватает рекомендуемого поля: право на расширенный результат есть, но информации в нём будет меньше.
- Сверьте разметку с тем, что видит посетитель. Цена, рейтинг, автор и даты в JSON-LD должны совпадать с видимой страницей. Правила Google запрещают размечать то, чего читатель не видит.
- Опубликуйте и наблюдайте. В Search Console проверьте живой URL инструментом проверки URL и запросите индексирование, затем следите за отчётом по этому типу в ближайшие недели.
Пример: сломанный блок Product и исправленная версия
Блок выглядит безобидно, но в нём четыре ошибки:
{
"@context": "https://schema.org",
"@type": "product",
"name": "Кроссовки для трейла",
"offers": {
"@type": "Offer",
"price": "1 299,00 грн",
"availability": "в наличии",
}
}
- запятая после последнего свойства делает JSON невалидным — остальное в блоке вообще не читается;
productс маленькой буквы — не тип schema.org: регистр важен;- в цене пробел, запятая и валюта; цена — просто число, валюта — в
priceCurrency; в наличии— свободный текст, а не значение перечисленияItemAvailability.
Исправленный вариант:
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Кроссовки для трейла",
"image": "https://example.com/img/shoes.jpg",
"offers": {
"@type": "Offer",
"price": "1299.00",
"priceCurrency": "UAH",
"availability": "https://schema.org/InStock"
}
}
Для сниппета товара в Google объекту Product нужны name и хотя бы одно из offers, review или aggregateRating; внутри Offer обязательна price.
Частые ошибки микроразметки и как их исправить
| Что видите | Как исправить |
|---|---|
| Ошибка разбора / unexpected token | Ищите запятую перед } или ], пропущенную запятую между свойствами или неэкранированную кавычку внутри значения. |
| Кавычки-«ёлочки» или “ ” в коде | Код прошёл через Word или визуальный редактор. Вставляйте JSON-LD в HTML-режиме или в поле кода CMS. |
Комментарии // внутри JSON-LD | Удалите. В справке Google сказано, что Rich Results Test комментарии игнорирует, но стандарт JSON-LD их не допускает, и другие парсеры могут сломаться. |
| Неизвестный тип или свойство | Проверьте написание и регистр: datepublished → datePublished, localbusiness → LocalBusiness. |
| Свойство не относится к типу | Перенесите в нужный объект: например, price — в Offer, а не прямо в Product. |
| Неверная дата | 13.10.2026 → 2026-10-13 или 2026-10-13T09:00:00+03:00. |
| Неверная длительность | "cookTime": "30 мин" → "PT30M"; полтора часа — "PT1H30M". |
| Две разные Organization | Обычно одну выводит SEO-плагин, другую — тема. Оставьте одну, дайте ей @id и ссылайтесь на неё из других блоков. |
| Типы data-vocabulary.org | Google этот старый словарь больше не поддерживает. Перепишите разметку на schema.org. |
Валидная разметка не гарантирует расширенный результат
Google прямо пишет в правилах для структурированных данных, что не гарантирует расширенные результаты, даже если разметка проходит Rich Results Test. Корректная разметка даёт право на показ, а покажет ли его алгоритм для конкретного запроса и пользователя — решает Google. Частые причины, почему у валидного объекта ничего нет:
- Функцию больше не показывают. Список ниже.
- Нарушение правил. Разметка того, чего нет на странице, вводящие в заблуждение или устаревшие данные, фальшивые отзывы. Ручная мера за структурированные данные лишает права на расширенные результаты; по словам Google, на ранжирование в веб-поиске она не влияет.
- Отзывы о себе. Звёзды для LocalBusiness и Organization Google показывает только сайтам, которые собирают отзывы о других компаниях. Компания, разметившая рейтинг самой себя, звёзд не получит.
- Страница ещё не проиндексирована или Google не переобходил её после изменения разметки.
Что Google перестал показывать
- FAQ — с сентября 2023 года только для авторитетных сайтов госорганов и здравоохранения, с 7 мая 2026 года не показывается вовсе; документацию удалили в июне 2026-го.
- How-to — убран в сентябре 2023 года на десктопе и мобильных.
- Окно поиска по сайту (WebSite + SearchAction) — отключено в ноябре 2024 года.
- Хлебные крошки — с января 2025 года не показываются в мобильной выдаче, на десктопе остались.
- Course info, Estimated salary, Learning video, Special announcement, Vehicle listing — документация удалена в сентябре 2025 года.
Такая разметка остаётся корректной schema.org и ничего не ломает — Google просто не превращает её в визуальный элемент. Оставлять ли её — вопрос затрат на поддержку, а не риска.
JSON-LD, добавленный через JavaScript или Google Tag Manager
Многие сайты вставляют разметку скриптом или тегом «Пользовательский HTML» в Google Tag Manager. В руководстве Google по созданию структурированных данных с помощью JavaScript сказано, что Google Поиск обрабатывает разметку, которая есть в DOM при отрисовке страницы. Из этого два следствия:
- Инструменты, которые читают только исходный HTML (в том числе наш), такую разметку не увидят. Проверяйте эти страницы в Rich Results Test (он работает с отрисованным кодом) или инструментом проверки URL в Search Console. Другой способ: откройте страницу в Chrome DevTools, скопируйте отрисованный элемент
<html>(Elements → Copy → Copy outerHTML) и вставьте в валидатор. - Для разметки Product Google предупреждает: динамическая разметка может сделать сканирование для Покупок реже и менее надёжным. Если цена и наличие меняются часто, отдавайте JSON-LD в серверном HTML.
В GTM собирайте разметку из переменных страницы, а не вписывайте значения в тег вручную — иначе разметка со временем разойдётся с тем, что видит посетитель.
Проверка микроразметки в Search Console
Отчёты о расширенных результатах лежат в разделе «Улучшения»; сниппеты товаров и товарные объявления — в разделе «Покупки». Что важно знать:
- Отчёт появляется, только когда Google нашёл валидную разметку поддерживаемого типа. Отчёта по FAQ или How-to ждать не стоит.
- Считаются объекты, а не страницы: страница с тремя Event даёт три объекта.
- В отчёте — выборка, а не все URL. Для конкретной страницы используйте проверку URL.
- Объект с критической проблемой невалиден и не может стать расширенным результатом; некритические проблемы — предупреждения.
- Исправив проблему, запустите проверку исправления на странице этой проблемы — отчёт покажет её статус.
Как проверить разметку в PromoPilot
Введите URL или вставьте код в валидатор Schema.org. Он находит все объекты JSON-LD, Microdata и RDFa и проверяет их в три слоя:
- Синтаксис: ошибки JSON со строкой и столбцом, причина простыми словами и безопасная автопочинка (висящие запятые, комментарии, «типографские» кавычки, переносы строк внутри значений, несколько объектов подряд) — с исправленным блоком для копирования.
- Словарь: типы и свойства сверяются со schema.org (сейчас версия 30.1), с подсказками при опечатках и неверном регистре, устаревших терминах, значениях перечислений, датах и длительностях ISO 8601.
- Правила Google: обязательные и рекомендуемые поля для статей, товаров, отзывов, хлебных крошек, организаций, местных компаний, мероприятий, рецептов, видео, приложений и вакансий.
Кроме того, он собирает @graph, разрешает ссылки @id и находит дубли сущностей. Вставленный код — до 512 КБ, загруженная страница кэшируется на 10 минут. Создать разметку с нуля помогут генератор Schema (Article, Product, FAQ, Organization, LocalBusiness, Breadcrumbs) и генератор FAQ-разметки.
Чего наш валидатор не делает
- Не выполняет JavaScript: разметку из GTM или одностраничного приложения он не видит. Если на странице есть GTM или она похожа на SPA, он об этом предупредит.
- Не сверяет разметку с видимым текстом. Цена в JSON-LD, отличная от цены на странице, — нарушение правил Google, но автоматически его не поймать.
- Не обещает расширенный результат — этого не может обещать никто, кроме самого Google.
Что почитать дальше
- Структурированные данные и Schema.org — что это и какие типы важны.
- Блок ответа (featured snippet) — его разметкой не включить.
- Проверка мета-тегов и превью сниппета — остальное, из чего складывается вид страницы в выдаче.