Poradniki

Schema JSON-LD — co warto wdrożyć na stronie i jak to zrobić bez kodowania

Dane strukturalne w formacie JSON-LD to jeden z najprostszych sposobów, żeby Google lepiej rozumiał treść Twojej strony — i pokazywał ją w wynikach wyszukiwania w bardziej atrakcyjny sposób (gwiazdki, pytania FAQ, okruszki nawigacyjne). Nie musisz pisać kodu ręcznie — generator schematu JSON-LD złoży gotowy fragment w kilka sekund.

Czym jest schema.org i JSON-LD

Schema.org to wspólny słownik pojęć (stworzony przez Google, Bing, Yahoo i Yandex), który opisuje typy treści na stronie — artykuł, produkt, przepis, wydarzenie, firmę, pytania i odpowiedzi. JSON-LD to format zapisu tych informacji — blok kodu w formacie JSON, który wstawia się w sekcji <head> lub <body> strony, niewidoczny dla użytkownika, ale czytelny dla wyszukiwarek.

W przeciwieństwie do starszych metod (mikrodane w atrybutach HTML), JSON-LD jest oddzielony od warstwy wizualnej strony — można go dodać bez ingerencji w szablon, co czyni go dziś standardem rekomendowanym przez Google.

Dlaczego Google tego używa

Dane strukturalne pozwalają Google generować tzw. rich results — rozszerzone wyniki wyszukiwania, które wyróżniają się na tle zwykłych niebieskich linków:

  • gwiazdki oceny przy produktach i przepisach,
  • rozwijane pytania i odpowiedzi (FAQPage) bezpośrednio pod wynikiem,
  • okruszki nawigacyjne (BreadcrumbList) zamiast surowego adresu URL,
  • informacje o autorze i dacie publikacji artykułu.

Rich results zwiększają współczynnik klikalności (CTR) — wynik zajmuje więcej miejsca na ekranie i wygląda bardziej wiarygodnie, nawet bez zmiany pozycji w rankingu.

Najważniejsze typy schema dla małych stron

Article

Opisuje artykuł blogowy — tytuł, autora, datę publikacji i modyfikacji, obrazek. Warto wdrożyć na każdym wpisie blogowym, żeby Google poprawnie identyfikował treść jako artykuł, a nie stronę produktową czy usługową.

FAQPage

Oznacza sekcję pytań i odpowiedzi na stronie. Jeśli artykuł kończy się blokiem FAQ (jak ten), ten typ schema pozwala Google pokazać rozwijane pytania bezpośrednio w wynikach wyszukiwania — zajmują więcej miejsca i przyciągają wzrok.

Product

Dla sklepów internetowych — cena, dostępność, ocena klientów. To ten typ schema odpowiada za gwiazdki i cenę widoczne przy wynikach produktowych.

Okruszki nawigacyjne — zamiast pełnego adresu URL Google pokazuje ścieżkę w stylu „Strona główna › Kategoria › Podstrona”. Poprawia czytelność wyniku i pomaga użytkownikowi zrozumieć strukturę serwisu jeszcze przed kliknięciem.

Organization

Podstawowe dane o firmie — nazwa, logo, adres, profile w mediach społecznościowych. Wspiera budowanie tzw. Knowledge Panel i wiarygodność marki w oczach wyszukiwarki.

Przykład kodu JSON-LD dla FAQ

Poniżej minimalny, poprawny przykład schema typu FAQPage z jednym pytaniem:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "Czym jest JSON-LD?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "JSON-LD to format zapisu danych strukturalnych, czytelny dla wyszukiwarek i niewidoczny dla użytkownika."
    }
  }]
}

Taki blok wkleja się w kod strony w znaczniku <script type="application/ld+json">. Generator online automatycznie tworzy tę strukturę na podstawie wpisanych przez Ciebie pytań i odpowiedzi — bez ręcznego pilnowania nawiasów i przecinków.

Gdzie wkleić kod JSON-LD na stronie

Gotowy fragment kodu z generatora umieszcza się wewnątrz znacznika <script type="application/ld+json">...</script>. Najczęściej trafia on do sekcji <head> strony, choć równie dobrze zadziała na końcu <body> — dla wyszukiwarki lokalizacja w kodzie nie ma znaczenia, liczy się tylko poprawna składnia JSON.

W WordPressie masz kilka opcji: wkleić kod bezpośrednio w pliku szablonu (np. header.php lub footer.php przez warunek is_singular()), użyć pola „Custom HTML” w edytorze wpisu, albo skorzystać z wtyczki, która pozwala dodawać własny kod per strona bez ingerencji w pliki motywu. Ta ostatnia opcja jest najbezpieczniejsza, jeśli nie czujesz się pewnie w edycji plików PHP.

Jak zweryfikować wdrożone dane

Po wdrożeniu schema warto sprawdzić, czy Google poprawnie je odczytuje. Do tego służy darmowe narzędzie Google — Rich Results Test — wystarczy wkleić adres URL strony lub sam kod JSON-LD, a narzędzie pokaże, czy dane są poprawne i które elementy rich results się kwalifikują.

Częsty błąd — duplikowanie schema

Jeśli korzystasz z wtyczki SEO (np. Rank Math, Yoast), która automatycznie generuje schema Article lub FAQPage, a jednocześnie ręcznie wkleisz ten sam typ schema w treści strony — powstanie duplikat. Google w takiej sytuacji może zignorować oba wystąpienia albo wybrać losowo jedno z nich, co obniża skuteczność rich results. Zasada jest prosta: jeden typ schema na stronę powinien pochodzić z jednego źródła — albo z wtyczki, albo wklejony ręcznie, nigdy z obu naraz.

Najczęściej zadawane pytania

Czy schema JSON-LD poprawia pozycję w Google?

Samo dane strukturalne nie są bezpośrednim czynnikiem rankingowym, ale pośrednio poprawiają CTR dzięki rich results, co może przełożyć się na lepsze wyniki w dłuższej perspektywie.

Czy dane strukturalne są widoczne dla użytkownika?

Nie — kod JSON-LD jest niewidoczny na stronie. Widoczne są tylko jego efekty w wynikach wyszukiwania, np. gwiazdki czy rozwijane pytania.

Jak sprawdzić, czy schema działa poprawnie?

Najszybciej przez Google Rich Results Test — wystarczy wkleić adres URL lub kod JSON-LD, a narzędzie pokaże błędy i ostrzeżenia.

Czy WordPress dodaje schema automatycznie?

To zależy od motywu i wtyczek — wiele wtyczek SEO dodaje podstawowe schema automatycznie, ale bardziej szczegółowe typy (np. Product czy Recipe) często trzeba skonfigurować lub dodać ręcznie.

Podsumowanie

Dane strukturalne JSON-LD to niewielki wysiłek wdrożeniowy w zamian za realną szansę na lepszą widoczność w wynikach wyszukiwania. Nie musisz pisać kodu od zera — wygeneruj kod schema online, wklej gotowy fragment na stronę i zweryfikuj go w Rich Results Test.

Autor wpisu

Michał