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ą.
