Частые ошибки микроразметки и как их исправить

Ошибки микроразметки делятся на две группы: критические (поисковик не использует разметку вообще) и рекомендации (разметка работает, но её можно усилить). Ниже - самые частые проблемы, которые находит валидатор Schema.org, и способы их решения.

1. Синтаксическая ошибка JSON-LD

Самая частая причина невалидной разметки - сломанный JSON: лишняя запятая перед закрывающей скобкой, незакрытые кавычки или скобки. Такой блок поисковик не разбирает целиком.

Неправильно: лишняя запятая после последнего свойства

{
  "@type": "Article",
  "headline": "Заголовок",
}

Правильно

{
  "@type": "Article",
  "headline": "Заголовок"
}

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

2. Пропущены @context или @type

Без @context со ссылкой на schema.org и без @type поисковик не понимает, к какому словарю и типу относится объект. Это делает разметку бесполезной, даже если остальные свойства заполнены.

Решение: каждый корневой объект JSON-LD должен начинаться с "@context": "https://schema.org" и "@type". Во вложенном @graph дочерние объекты наследуют контекст от родителя.

3. Нет обязательных свойств

У многих типов есть свойства, без которых расширенный сниппет не появится. Например, у Product нужно хотя бы одно из offers, review или aggregateRating; у Event - name, startDate и location; у BreadcrumbList - itemListElement.

Решение: сверьтесь со справочником типов и добавьте недостающие обязательные свойства.

4. Разметка не совпадает с контентом

Google и Яндекс требуют, чтобы структурированные данные описывали то, что реально видит пользователь. Частая ошибка - разметить в FAQPage вопросы, которых нет на странице, или указать в AggregateRating рейтинг, который нигде не показан.

Решение: размечайте только видимый контент. Текст ответов FAQ, цена товара, рейтинг и отзывы должны присутствовать на самой странице, а не только в разметке.

5. Неверный формат даты, цены или URL

Даты должны быть в формате ISO 8601 (например, 2026-02-01), цена - числом без символа валюты, а валюта - отдельным свойством priceCurrency. URL указывайте абсолютными, со схемой https.

Правильный формат цены

"offers": {
  "@type": "Offer",
  "price": "1290",
  "priceCurrency": "RUB"
}

Решение: уберите из числовых значений пробелы, символы валюты и лишние знаки. Приводите даты к формату ГГГГ-ММ-ДД.

6. Спам-разметка и накрутка рейтинга

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

Решение: используйте только достоверные данные. Рейтинг и отзывы должны быть настоящими и собранными от реальных пользователей.

7. Разметку не видит робот

Иногда разметка добавляется скриптом уже после загрузки страницы, и робот её не всегда получает. Ещё одна причина - ресурсы заблокированы в robots.txt.

Решение: по возможности выводите JSON-LD в исходном HTML. Проверьте страницу по URL в Rich Results Test - он показывает разметку в том виде, в каком её видит поисковик. Как это сделать, описано в руководстве как проверить микроразметку.