Как пользоваться
- Введите каждый вопрос и ответ так, как они отображаются на странице.
- Добавляйте пары, перемещайте их вверх или вниз либо удаляйте ненужные. Незавершённые пары не включаются в результат и помечаются.
- Скопируйте скрипт и вставьте его в HTML страницы — в head или body.
- Проверьте страницу валидатором структурированных данных, чтобы убедиться, что разметка считывается правильно.
Как это работает
Генератор создаёт объект FAQPage по schema.org: для каждой пары формируется элемент Question с принятым ответом acceptedAnswer типа Answer. JSON создаётся с помощью настоящего сериализатора JSON, поэтому кавычки, обратные косые черты и переносы строк в тексте корректно экранируются. Кроме того, каждый символ «<», «>» и «&» записывается в виде escape-последовательности \u. Это не позволяет тексту вроде «</script>» или «<!--» в ответе преждевременно закрыть элемент script и нарушить работу страницы, при этом парсеры JSON по-прежнему считывают исходные символы.
О расширенных результатах: в августе 2023 года Google ограничил расширенные результаты FAQ авторитетными сайтами государственных учреждений и медицинской тематики. Для большинства остальных сайтов разметка FAQPage больше не выводит раскрывающиеся вопросы в Google Search. Она остаётся допустимыми структурированными данными, описывающими страницу, и может использоваться другими сервисами, работающими с данными schema.org.
Рекомендации: вопросы и ответы в разметке должны быть видны и на странице; у каждого вопроса должен быть один ответ, написанный владельцем сайта (если пользователи могут отправлять ответы, используйте тип QAPage); разметку нельзя использовать для рекламы. Ответы могут содержать простой HTML, например ссылки и списки, — рекомендации Google допускают его в тексте ответа.
Примеры
Страница поддержки товара
Три вопроса о доставке, возврате и гарантии превращаются в FAQPage с тремя элементами Question. Добавьте скрипт один раз на страницу поддержки, где показаны эти вопросы.
Ответ с кодом
Ответ с текстом «</script>» выводится в JSON как \u003c/script\u003e, поэтому тег script на странице остаётся целым, а видимый текст не меняется.
Часто задаваемые вопросы
Поможет ли разметка FAQ получить расширенный результат в Google?
Скорее всего, нет — если только это не авторитетный сайт государственного учреждения или медицинской тематики. В 2023 году Google ограничил расширенные результаты FAQ такими сайтами. Разметка по-прежнему допустима и может считываться другими сервисами.
Куда добавить скрипт JSON-LD?
В любом месте HTML — в head или body. Она ничего не отображает. Добавляйте её только на страницу, где действительно показаны эти вопросы и ответы.
Можно ли добавлять ссылки в ответы?
Да. Рекомендации Google по FAQ допускают ограниченный набор HTML-тегов в ответах, например ссылки, списки и абзацы. Введите HTML в поле ответа — для скрипта он будет безопасно экранирован.
Почему в результате есть последовательности \u003c?
Это escape-последовательности JSON для символа «<». Такая запись не позволяет тексту в ответах закрыть тег script. Любой обработчик JSON-LD преобразует её обратно в «<».
Конфиденциальность
Разметка создаётся в браузере. Ваши вопросы и ответы никуда не отправляются и не сохраняются.