Przejdź do treści
Manuilau | Bureau

Wzorzec · TypeScript

FAQ i HowTo w JSON-LD: kiedy markup ma sens

Unikaj oznaczania „dla gwiazdek”: tylko widoczna treść, jeden sens na stronę, wytyczne Google.

Poziom: zaawansowanySzacunek czasu: ~30 min na politykę

“

Google może zignorować lub ukarać markup, jeśli pytania nie zgadzają się z widocznym tekstem albo duplikują cały landing.

  • Każda odpowiedź FAQ musi być na stronie wyraźnie
  • nie oznaczaj całego katalogu jako HowTo
  • śledź dokumentację typów w Search Central

FAQPage i HowTo dają rozszerzenia w SERP tylko przy zasadach: treść dla ludzi, pełna zgodność z HTML, brak spamu i ukrytego tekstu.

Kod

Ilustracyjny fragment (nie kopiuj ślepo — sprawdzaj aktualną specyfikację Google):

const faqLd = {
  '@context': 'https://schema.org',
  '@type': 'FAQPage',
  mainEntity: [
    {
      '@type': 'Question',
      name: 'Czy krótkie pytanie jest takie samo jak na stronie?',
      acceptedAnswer: {
        '@type': 'Answer',
        text: 'Tak — dosłowna zgodność z widocznym akapitem pod pytaniem.',
      },
    },
  ],
}

Weryfikacja

  • Każde pytanie/odpowiedź w JSON-LD jest w DOM i dostępne użytkownikowi bez pustych akordeonów-zaślepek.
  • Rich Results Test: brak krytycznych błędów; brak dziesiątek słabych duplikatów pytań.

Źródła

Wdrożyć pod Twoją domenę i stack?

Krótki formularz: imię, telefon, strona. Po wysłaniu — odpowiedź z kolejnością prac i orientacją etapów; szczegóły doprecyzujemy na kontakcie.