Как добавить микроразметку FAQPage на сайт: JSON-LD по шагам с проверкой

Аккордеон «Вопрос-ответ» на сайте есть, а валидатор микроразметки пустой: скопировали JSON-LD из гайда 2023 года, вставили 12 вопросов, на странице видны четыре. Маркетолог ждёт сниппет в Google, хотя с 7 мая 2026 FAQ rich result снят. За день соберёте видимый FAQ на 3-5 пар, напишете JSON-LD FAQPage один в один с HTML и проверите в Schema Markup Validator и Яндекс Вебмастере - без обещаний аккордеона в выдаче Google.

Микроразметка - машиночитаемое описание страницы для поисковиков и нейросетей. JSON-LD - это JSON внутри script в коде сайта. FAQPage по Schema.org означает: страница с частыми вопросами. Типичная ошибка: путать разметку с аккордеоном. Без script в head или footer для робота FAQ не существует.

Google с августа 2023 оставил FAQ rich results только для gov/health, 7 мая 2026 убрал feature полностью. Неиспользуемая structured data не вредит - удалять не обязательно. На GitHub в schemaorg issue #4816 предлагают FAQSection для FAQ внутри Product или Article: FAQPage семантически «вся страница = FAQ», что ломает граф на лендингах.

Аккордеон в выдаче Google снят с мая 2026 - разметка остаётся

Боль: половина RU-гайдов до сих пор обещает «выпадение вопросов в SERP», и команда тратит недели на ожидание. Решение: сменить KPI. С 7 мая 2026 Google не показывает FAQ rich result никому; в июне 2026 убрали даже документацию feature. Rich Results Test для FAQ уходит - опирайтесь на validator.schema.org.

Зачем оставлять микроразметку faq schema: Яндекс и Bing читают Schema.org; AI-ответы цитируют структурированные Q&A. Разметка - страховка, что машина видит тот же текст, что и человек.

Вердикт: не ждите аккордеон в Google. Ждите зелёный валидатор, совпадение текста и чистый отчёт без дублей FAQPage на одном URL.

Три-пять вопросов, которые пользователь реально читает в HTML

Боль: FAQ спрятан в JS без текста в DOM, или в schema 12 вопросов, а на экране четыре. Решение: аудит видимости до любого кода.

1. Откройте страницу без авторизации, прокрутите до блока FAQ. Вопрос и полный ответ должны быть в HTML, не только в data-атрибутах аккордеона.
2. Выберите 3-5 пар, которые закрывают реальные возражения: срок, цена, гарантия, «чем отличаетесь». Не fabricate «лучшая компания в городе» ради SEO.
3. Сверьте intent страницы: если URL целиком про FAQ (справка, база знаний) - FAQPage уместен. Если FAQ - секция на лендинге услуги, помните про ограничение: FAQPage = «страница целиком FAQ». На коммерческих лендингах не размечайте весь URL как FAQPage без оснований; следите за обсуждением FAQSection в schemaorg issue #4816.
4. Ответы пишите полными предложениями. Один абзац на вопрос - норма.

В реальном проекте маркетолог скопировал чужой JSON с двенадцатью generic-вопросами. Validator показал синтаксис OK, но тексты не совпадали с аккордеоном - антипаттерн: mainEntity должен отражать видимые Q&A.

JSON-LD: копируйте текст с экрана, не с фантазии

Боль: путают FAQPage и QAPage, ставят suggestedAnswer вместо acceptedAnswer, ломают JSON кавычками. Решение: один канонический шаблон.

JSON-LD - это JSON внутри script. Поле mainEntity всегда массив, даже для одного вопроса. У Question поле name - текст вопроса; acceptedAnswer (не suggestedAnswer!) содержит Answer с полем text. suggestedAnswer - для QAPage, где ответы пишут пользователи.

Минимальный рабочий пример - скопируйте и подставьте свои тексты один в один:

Пример JSON-LD FAQPage (mainEntity - массив, даже для одного вопроса):
{
  «@context»: «https://schema.org»,
  «@type»: «FAQPage»,
  «mainEntity»: [
    {
      «@type»: «Question»,
      «name»: «Сколько времени занимает подключение?»,
      «acceptedAnswer»: {
        «@type»: «Answer»,
        «text»: «Стандартное подключение занимает 1-2 рабочих дня после подписания договора и передачи доступов.»
      }
    },
    {
      «@type»: «Question»,
      «name»: «Нужна ли предоплата?»,
      «acceptedAnswer»: {
        «@type»: «Answer»,
        «text»: «Да, 50% до старта работ, остаток после сдачи по акту.»
      }
    }
  ]
}

Типичная ошибка: в text вставляют HTML с неэкранированными кавычками. Лучше начать с чистого текста. Проверьте UTF-8 и валидность JSON до загрузки.

Один script в WordPress - без дубля от плагина и microdata

Боль: SEO-плагин уже генерирует FAQPage, а разработчик вставляет второй блок вручную - Search Console показывает duplicate. Решение: один источник на URL.

1. Выберите канал: дочерняя тема (functions.php + hook wp_head), плагин Code Snippets, или поле «Custom JSON-LD» в SEO-плагине. Не все три сразу.
2. Вставьте <script type=»application/ld+json»>…</script> в head или перед </body>. Google рекомендует JSON-LD как основной формат structured data.
3. Отключите FAQ-schema в плагине, если пишете вручную. Уберите itemscope itemtype FAQPage из HTML, если используете JSON-LD - не смешивайте microdata (разметку в атрибутах тегов) и JSON-LD на одной странице.
4. На мультиязычных сайтах один FAQPage на языковую версию URL, тексты совпадают с видимым блоком этой локали.

На практике SEO-плагин уже рисует FAQ из блока Gutenberg. Тогда ручной script не нужен - проверьте View Source, найдите единственный FAQPage.

Два валидатора микроразметки schema: schema.org и Яндекс Вебмастер

Боль: смотрят только устаревающий Rich Results Test и паникуют, что «FAQ не поддерживается». Решение: двойная проверка по чек-листу 30 июля 2026. Рекомендуем не останавливаться на одном инструменте.

1. Schema Markup Validator - вставьте URL или сырой JSON-LD. Цель: 0 синтаксических ошибок, тип FAQPage распознан.
2. Яндекс Вебмастер - Валидатор микроразметки - проверка URL или HTML с учётом требований сервисов Яндекса.
3. Сравните name и text в JSON с видимым аккордеоном побуквенно. Убедитесь, что расхождений нет - иначе риск для доверия парсеров.
4. В Google Search Console откройте отчёт по structured data: не должно быть двух FAQPage на одном URL.

Rich Results Test для FAQ в 2026 не цель. Если инструмент ещё открывается, он не вернёт FAQ-сниппет - feature снят. Ориентир: validator.schema.org + Яндекс.

Чек-лист 2026: что считать успехом без Google-аккордеона

Боль: команда не понимает, сработало ли. Решение: явные success criteria до празднования. Важно: празднуйте только после проверки, не после вставки кода.

Итог: вы на финише и получите рабочий FAQPage, если:

• На странице видимый FAQ с 3-5 парами вопрос-ответ в HTML. Не делайте скрытый FAQ только в script.
• Один блок script type=»application/ld+json» с @type FAQPage и mainEntity из Question/Answer.
• validator.schema.org - без синтаксических ошибок.
• Яндекс Вебмастер распознаёт FAQPage на URL.
• Текст в name и text совпадает с аккордеоном.
• В Search Console нет дублей FAQPage на одном адресе.

Что дальше: свяжите FAQPage с Article или Organization schema на той же странице; обновите llms.txt ссылкой на FAQ-раздел; пройдите GEO-чеклист для AI-поиска. После этого сможете запустить повторную проверку в валидаторах и зафиксировать результат в Search Console. Нужен аудит разметки под ваш стек - на calmopsai.com.

Материал проверен: Алексей Доронин, эксперт по автоматизации и SEO/GEO.
Достоверность: даты депрекации FAQ rich result (май-июнь 2026), структура FAQPage/Question и рекомендация JSON-LD сверены с schema.org, Google Search Central и документацией Яндекс Вебмастера на 30 июля 2026. Показы Wordstat в этом прогоне не верифицированы live - частотности из scout B37 не выдумывались.

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

Нужна ли FAQPage после отмены FAQ rich results в Google?

Да, если у вас есть видимый блок вопросов и вы хотите, чтобы Яндекс, Bing и AI-системы однозначно читали Q&A. Google с 7 мая 2026 не показывает FAQ-аккордеон в выдаче, но валидная разметка не штрафуется. KPI - парсинг и GEO, не CTR от сниппета.

Можно ли размечать FAQ без видимого блока на странице?

Нет. Текст в JSON-LD должен совпадать с тем, что видит пользователь. Скрытый FAQ только в script без HTML в DOM - нарушение духа guidelines и риск для доверия. Сначала аккордеон в вёрстке, потом копия в mainEntity.

Чем FAQPage отличается от QAPage?

FAQPage - один официальный ответ сайта в acceptedAnswer. QAPage - страница с пользовательскими ответами в suggestedAnswer (форум, Q&A-сервис). Для лендинга с аккордеоном от компании берите FAQPage.

Можно ли совмещать JSON-LD и microdata на одной странице?

Для одного и того же FAQPage - нет. Выберите JSON-LD (рекомендация Google) или microdata itemscope, но не оба формата с типом FAQPage. Иначе валидаторы и Search Console видят дубли полей.

Какой валидатор микроразметки schema выбрать в 2026?

Базовый минимум: validator.schema.org для синтаксиса Schema.org плюс Яндекс Вебмастер для российской выдачи. Rich Results Test для FAQ не даёт обещаний rich result после майской депрекации Google.

Стоит ли ждать FAQSection вместо FAQPage на лендинге?

FAQSection пока предложение в обсуждении schemaorg (#4816), не стабильный тип. Пока канон - FAQPage только если страница по смыслу целиком FAQ; на лендинге услуги не натягивайте тип на весь URL из-за одной секции.