# Test danych strukturalnych Wpisz adres strony, aby odczytać jej JSON-LD tak, jak widzi go przeglądarka po wykonaniu skryptów. Narzędzie wymienia każdy typ schema.org, znajduje bloki, których wyszukiwarki nie potrafią przetworzyć, i sprawdza każdą pozycję pod kątem właściwości wymaganych i zalecanych w dokumentacji Google. ## Co sprawdza to narzędzie - Błędy składni JSON: Każdy blok JSON-LD jest parsowany tak, jak zrobiłaby to wyszukiwarka. Blok ze zbędnym przecinkiem lub cudzysłowem jest zgłaszany wraz z komunikatem parsera, ponieważ wyszukiwarki ignorują cały taki blok. - Kontekst schema.org: Bloki bez "@context": "https://schema.org" są oznaczane, bo wyszukiwarki nie wiedzą, jakiego słownika używają. - Każda pozycja, także w @graph: Pozycje na najwyższym poziomie i wewnątrz @graph, a także mainEntity i breadcrumb strony, każda z typem oraz nazwą lub nagłówkiem. - Właściwości wymagane przez Google: Pozycje Product, Article, Breadcrumb, Organization, Local business, Event, Video, Recipe, Software app, Job posting i nazwa witryny (WebSite) są sprawdzane pod kątem tego, co Google oznacza jako wymagane. - Właściwości zalecane: To, co Google zaleca dla każdego wyniku z elementami rozszerzonymi, na przykład image i availability dla produktów albo datePublished i author dla artykułów. - Wycofane wyniki z elementami rozszerzonymi: Pozycje FAQPage i HowTo są wymieniane z adnotacją: Google nie pokazuje już tych wyników z elementami rozszerzonymi, więc znaczniki ich nie zapewnią. - Znaczniki dodawane przez JavaScript: Strona jest uruchamiana w Chrome, zanim ją odczytamy, więc uwzględniamy także JSON-LD wstawiony przez skrypty lub menedżer tagów. ## Czego nie może sprawdzić - Zagwarantować wyniku z elementami rozszerzonymi. O tym, czy go pokazać, decyduje Google; poprawne znaczniki jedynie sprawiają, że strona się do niego kwalifikuje. - Sprawdzić każdej reguły z przewodników Google. Niektóre zależą od wartości, takich jak rozmiary obrazów oraz formaty cen i dat; punktem odniesienia jest Test wyników z elementami rozszerzonymi od Google. - Sprawdzić właściwości mikrodanych ani RDFa. Te formaty są wymieniane tylko według typu. - Potwierdzić, że znaczniki odpowiadają temu, co pokazuje strona. Google tego wymaga, a porównać jedno z drugim może tylko człowiek. - Przetestować więcej niż podaną stronę. ## Dlaczego to ważne Dane strukturalne opisują stronę maszynom w standardowy sposób: to jest produkt o tej cenie, to jest artykuł tego autora, to jest organizacja stojąca za witryną. Google wykorzystuje je, aby rozumieć strony i pokazywać wyniki z elementami rozszerzonymi, takie jak ceny, oceny i ścieżki nawigacyjne (breadcrumbs). Ich błędy są niewidoczne. Uszkodzony blok JSON-LD nie zmienia wyglądu strony, a brak wymaganej właściwości po cichu sprawia, że pozycja traci możliwość uzyskania wyniku z elementami rozszerzonymi. Search Console zgłasza część tych problemów, ale tylko dla stron, które Google już przeskanował. To nie jest skrót do odpowiedzi AI. Google podaje, że AI Overviews (Przegląd od AI) i AI Mode (tryb AI) nie wymagają żadnych specjalnych znaczników schema.org. Liczy się to, by znaczniki były poprawne i odpowiadały temu, co pokazuje strona. ## Jak czytać wyniki - Poprawny JSON lub nie da się odczytać: Czy blok daje się sparsować. Blok, którego nie da się odczytać, jest całkowicie ignorowany, bez względu na zawartość. - Brak wymaganych właściwości: Pozycja nie może uzyskać wyniku z elementami rozszerzonymi, dopóki ich nie dodasz, a Search Console wymieni ją jako nieprawidłową. - Zalecane właściwości do dodania: Pozycja kwalifikuje się do wyniku; te właściwości mogą go wzbogacić. Dodawaj tylko wartości, które są prawdziwe i widoczne na stronie. - Kompletne: Wymagane i zalecane właściwości są obecne. Ich wartości nadal muszą być poprawne. - Brak testów wyników z elementami rozszerzonymi: Poprawny typ, taki jak WebPage lub ImageObject, dla którego Google nie ma wyniku z elementami rozszerzonymi z wymaganymi właściwościami. - Google nie pokazuje już tego wyniku z elementami rozszerzonymi: FAQ (od 7 maja 2026 r.) i How-to (od września 2023 r.). Pozostawienie znaczników nie szkodzi. - a / b: Wymóg spełnia dowolna z tych właściwości, na przykład offers / review / aggregateRating dla produktu. ## Jak naprawić najczęstsze problemy - Przecinek na końcu lub cudzysłów bez znaku ucieczki: To najczęstsze błędy składni. Wklej blok do walidatora JSON, aby znaleźć miejsce błędu, a cudzysłowy podwójne w wartościach tekstowych poprzedź ukośnikiem odwrotnym. - Product bez offers, review ani oceny: Fragment rozszerzony produktu w Google wymaga nazwy oraz offers, review lub aggregateRating. Platformy sklepowe zwykle generują offers z ceną i dostępnością; jeśli Twoja tego nie robi, sprawdź motyw lub aplikację SEO. - Ocena bez liczby ocen: aggregateRating wymaga ratingValue oraz ratingCount lub reviewCount. Oznaczaj tylko oceny, które odwiedzający widzą na stronie: wytyczne Google nie pozwalają na znaczniki dla treści, która nie jest widoczna. - Dwie wtyczki, dwa zestawy znaczników: Motywy, wtyczki SEO i aplikacje mogą niezależnie od siebie dodawać dane Product lub Organization. Duplikaty z różnymi wartościami nikomu nie pomagają: zostaw jedno źródło, a pozostałe wyłącz. - Elementy ścieżki nawigacyjnej bez adresów: Każdy ListItem wymaga adresu URL w item (z wyjątkiem ostatniego, którym może być bieżąca strona) oraz nazwy, a lista musi mieć co najmniej dwa elementy. - Nazwa witryny i organizacja na stronie głównej: Dodaj na stronie głównej WebSite z name i url, aby przekazać Google nazwę witryny, oraz Organization z url, logo i linkami sameAs do oficjalnych profili. ## Najczęściej zadawane pytania ### Czym jest JSON-LD? To sposób zapisu danych strukturalnych jako obiektu JSON wewnątrz elementu script, oddzielnie od widocznego kodu HTML. Google zaleca go, gdy pozwala na to Twoja konfiguracja, bo to format najłatwiejszy do dodania i utrzymania. ### Dlaczego po dodaniu znaczników nie widzę wyników z elementami rozszerzonymi? Google musi ponownie przeskanować stronę, a nawet wtedy przy każdym wyszukiwaniu decyduje, czy pokazać wynik z elementami rozszerzonymi. Google nie gwarantuje go nawet dla znaczników, które przechodzą jego testy. ### Czy dane strukturalne poprawiają pozycje w wynikach? Dokumentacja Google opisuje dane strukturalne jako sposób na zrozumienie treści i włączenie wyników z elementami rozszerzonymi, a nie jako czynnik rankingowy. Wyniki z elementami rozszerzonymi mogą jednak zwiększyć widoczność wpisu. ### Czy nadal warto dodawać znaczniki FAQ? Nie dla wyników z elementami rozszerzonymi w Google: Google przestał je pokazywać 7 maja 2026 r. Znaczniki są nadal poprawnym schema.org, więc nie trzeba ich usuwać, ale nie dodawaj ich w oczekiwaniu na wynik z elementami rozszerzonymi. ### Czy potrzebuję znaczników schema, aby pojawić się w AI Overviews lub ChatGPT? Google podaje, że AI Overviews i AI Mode nie wymagają żadnych specjalnych znaczników schema.org. Inne usługi AI nie publikują wymagań. Bezpiecznym podejściem jest czytelna treść z poprawnymi, rzetelnymi znacznikami. ### Czym to narzędzie różni się od Testu wyników z elementami rozszerzonymi od Google? Test wyników z elementami rozszerzonymi to punkt odniesienia Google i sprawdza również wartości. To narzędzie wymienia każdą pozycję na stronie prostym językiem, pokazuje, czego w każdej brakuje, i odsyła do odpowiedniego przewodnika. ## Źródła - [Google Search Central: wprowadzenie do znaczników danych strukturalnych](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data) - [Google Search Central: ogólne wytyczne dotyczące danych strukturalnych](https://developers.google.com/search/docs/appearance/structured-data/sd-policies) - [Google Search Central: galeria danych strukturalnych w wyszukiwarce](https://developers.google.com/search/docs/appearance/structured-data/search-gallery) - [Google Search Central: funkcje AI a Twoja witryna](https://developers.google.com/search/docs/appearance/ai-features) - [Google Search Central: najnowsze aktualizacje dokumentacji](https://developers.google.com/search/updates) - [Google: Test wyników z elementami rozszerzonymi](https://search.google.com/test/rich-results) - [Schema.org: Schema Markup Validator](https://validator.schema.org/)