Nodea — logo

JSON-LD

JSON-LD (JSON for Linking Data) to format zapisu danych strukturalnych, który wykorzystuje składnię JSON do opisywania zawartości strony w sposób jednoznaczny dla wyszukiwarek. Dzięki niemu roboty nie muszą zgadywać, że dany fragment tekstu to cena, ocena produktu czy data wydarzenia — informacja jest podana wprost, słownikiem schema.org. Google jednoznacznie rekomenduje JSON-LD jako preferowany sposób dostarczania tych danych.

Jak działa JSON-LD?

Znaczniki umieszcza się w osobnym bloku <script type="application/ld+json"> w sekcji nagłówka lub treści dokumentu. Blok zawiera obiekt JSON opisujący encję — jej typ (@type), kontekst (@context wskazujący na schema.org) oraz właściwości:

  • @context — deklaruje słownik, z którego pochodzą właściwości (zwykle https://schema.org);
  • @type — określa rodzaj encji, np. Product, Article, FAQPage, LocalBusiness;
  • właściwości — pary klucz–wartość opisujące encję: nazwę, cenę, autora, ocenę, godziny otwarcia.

Kluczową zaletą jest oddzielenie tych danych od widocznego HTML — kod strony pozostaje czysty, a bloki JSON-LD można generować dynamicznie czy wstrzykiwać przez menedżer tagów, bez ingerencji w szablon.

Zastosowanie w praktyce

JSON-LD to fundament nowoczesnego technicznego SEO. Poprawnie opisane encje pozwalają uzyskać rich results: gwiazdki ocen, ceny i dostępność w sklepach, rozwijane pytania FAQ, breadcrumbs czy karty przepisów. Sklep internetowy oznacza w ten sposób produkty, portal informacyjny — artykuły, a firma lokalna — dane kontaktowe i godziny pracy, co zwiększa widoczność i klikalność w wynikach.

Do wdrożenia i weryfikacji służą narzędzia takie jak Test wyników z elementami rozszerzonymi oraz raport „Ulepszenia” w Google Search Console. Warto pamiętać o żelaznej zasadzie: dane w JSON-LD muszą odzwierciedlać treść faktycznie widoczną na stronie — rozbieżności są traktowane jako próba manipulacji.

Powiązane pojęcia

Najczęstsze pytania

Dlaczego Google zaleca JSON-LD zamiast microdata?

JSON-LD osadza się jako osobny blok skryptu, oddzielony od widocznego kodu HTML, więc nie trzeba przeplatać znaczników wewnątrz treści. Ułatwia to wdrożenie, testowanie i utrzymanie danych strukturalnych, a także wstrzykiwanie ich dynamicznie przez JavaScript lub menedżer tagów.

Czy JSON-LD gwarantuje wyświetlenie rich results?

Nie. Poprawnie wdrożony JSON-LD sprawia, że strona kwalifikuje się do rozszerzonych wyników, ale to Google ostatecznie decyduje, czy i kiedy je pokazać. Znaczniki muszą też odpowiadać rzeczywistej treści widocznej dla użytkownika, inaczej grozi to ignorowaniem danych lub karą ręczną.