К основному контенту

Паттерн · TypeScript

FAQ и HowTo в JSON-LD: когда разметка уместна

Избегайте разметки «ради звёздочек»: только видимый контент, один смысл на страницу, гайдлайны Google.

Уровень: продвинутыйОценка времени: ~30 мин на политику

Google может игнорировать или наказать разметку, если вопросы не совпадают с видимым текстом или дублируют весь лендинг.

  • Каждый ответ FAQ должен быть на странице явно
  • не размечайте весь каталог как HowTo
  • следите за документацией по типам в Search Central

FAQPage и HowTo дают расширения в выдаче только при соблюдении правил: контент для людей, полное совпадение с HTML, отсутствие спама и скрытого текста.

Код

Иллюстративный фрагмент (не копируйте слепо — сверяйтесь с актуальной спецификацией Google):

const faqLd = {
  '@context': 'https://schema.org',
  '@type': 'FAQPage',
  mainEntity: [
    {
      '@type': 'Question',
      name: 'Короткий вопрос в том же виде, что на странице?',
      acceptedAnswer: {
        '@type': 'Answer',
        text: 'Да — дословное совпадение с видимым абзацем под вопросом.',
      },
    },
  ],
}

Проверка

  • Каждый вопрос/ответ в JSON-LD есть в DOM и доступен пользователю без раскрытия «пустых» аккордеонов-заглушек.
  • Rich Results Test: нет критичных ошибок; нет дублирования десятков низкокачественных вопросов.

Первоисточники

Нужно внедрить под ваш домен и стек?

Короткая форма: имя, телефон и сайт. После отправки — ответ с порядком работ и ориентиром по этапам; задачу уточняют при контакте.