Czym jest JSON-LD?

JSON-LD (JavaScript Object Notation dla danych połączonych) to format danych strukturalnych zalecany przez wyszukiwarki. Strona zawiera blok <script type="application/ld+json">, który opisuje, czego dotyczy strona, na przykład produktu wraz z ceną, artykułu wraz z autorem lub organizacji wraz z logo, korzystając z typów i właściwości ze słownika schema.org. Google, Bing i inne wyszukiwarki odczytują te bloki, aby wyświetlać wyniki rozszerzone, takie jak oceny w postaci gwiazdek, ceny, nawigacja okruszkowa i karty przepisów.

Błędy w JSON-LD nie powodują widocznych komunikatów. Strona nadal się ładuje, ale brakujący przecinek, błędnie zapisany typ lub brak wymaganego pola sprawia, że wyszukiwarki ignorują znaczniki albo strona traci wynik rozszerzony.

Opis narzędzia

To narzędzie pobiera kod HTML strony na serwerze, wyszukuje wszystkie bloki skryptów JSON-LD i sprawdza każdy z nich w dwóch etapach. Najpierw sprawdza sam JSON-LD: czy JSON można sparsować, czy każdy element ma @context wskazujący na schema.org oraz @type, a także czy słowa kluczowe, takie jak @type i @id, są poprawnie zapisane i mają prawidłową strukturę. Następnie sprawdza zawartość względem słownika schema.org i zasad Google dotyczących wyników rozszerzonych, zgłaszając nieznane typy, właściwości, które nie należą do danego typu, oraz brakujące pola wymagane lub zalecane albo pola w nieprawidłowym formacie.

Funkcje

  • Wyszukuje wszystkie bloki JSON-LD na aktywnej stronie, w sekcji <head> lub <body>
  • Zgłasza błędy składni JSON wraz z komunikatem parsera
  • Sprawdza @context, @type, @id, @graph oraz pisownię słów kluczowych
  • Wykrywa nieznane typy schema.org oraz właściwości, których dany typ nie obsługuje
  • Sprawdza wymagane i zalecane przez Google pola dotyczące produktów, ofert, opinii, ocen, przepisów, ofert pracy, filmów, nawigacji okruszkowej i innych elementów
  • Wyświetla każdy element danych strukturalnych wraz z jego typem i nazwą
  • Pokazuje każdy blok jako sformatowany JSON

Jak to działa

Strona jest pobierana bez podążania za przekierowaniami, a odczytywane jest maksymalnie pierwsze 3 MB. Każdy blok JSON-LD jest analizowany osobno, a elementy znajdujące się w @graph są sprawdzane jako oddzielne elementy. Sprawdzanie schema.org korzysta z kopii pełnego słownika schema.org, natomiast sprawdzanie wyników rozszerzonych Google korzysta z otwartoźródłowego walidatora danych strukturalnych firmy Adobe.

Wskazówki

  • Błędy oznaczają, że wyszukiwarki prawdopodobnie zignorują element albo nie wyświetlą go jako wyniku rozszerzonego, dlatego należy najpierw je naprawić. Ostrzeżenia zwykle dotyczą zalecanych pól, a ich dodanie może poprawić wygląd wyniku.
  • Słowa kluczowe JSON-LD uwzględniają wielkość liter: @type działa, natomiast @Type nie.
  • Używaj bezwzględnych adresów URL w polach url, image i logo oraz dat w formacie ISO 8601, takich jak 2026-09-25 lub 2026-09-25T10:00:00+02:00.
  • Narzędzie odczytuje kod HTML zwrócony przez serwer. JSON-LD dodany później przez JavaScript w przeglądarce nie zostanie znaleziony.