
Dane strukturalne w sklepie internetowym - Product, Offer, warianty (ProductGroup) i BreadcrumbList w praktyce
Dane strukturalne w sklepie internetowym mówią Google, co sprzedajesz, za ile, czy jest dostępne i jak wygląda dostawa. Reguła: każda karta produktu, którą da się kupić, potrzebuje Product z Offer (cena większa od zera i waluta) w początkowym HTML strony. Dodaj GTIN zawsze, gdy produkt ma kod EAN, a zasady zwrotów i dostawy opisz raz dla całego sklepu (Organization albo Merchant Center), nie na każdej karcie. ProductGroup stosuj dopiero wtedy, gdy produkt ma co najmniej dwa warianty z własnym SKU, ceną albo dostępnością. Najczęstszy błąd, który znalazłem w polskich sklepach, to nie brak znaczników, tylko cena w danych inna niż ta, którą widzi kupujący.
Jakie dane strukturalne powinien mieć sklep: merchant listing czy krótki opis produktu, wymagane pola Product i Offer, zwroty i dostawa w Organization, warianty przez ProductGroup, okruszki, oceny, JSON-LD czy JavaScript, audyt 36 kart w 19 polskich sklepach, skrypt i pułapka z ceną promocyjną.
/// WPIS W SKRÓCIE
W tym wpisie pokazuję, czym różnią się wyniki produktowe od krótkiego opisu produktu, które pola Product i Offer są wymagane, a które warto dodać, gdzie opisać zwroty i dostawę, jak oznaczyć warianty przez ProductGroup, jak podać okruszki i oceny, czy dane mogą być wstrzykiwane przez JavaScript, wyniki mojego audytu 36 kart produktów w 19 polskich sklepach, skrypt do sprawdzania danych i pułapkę z ceną promocyjną.
Co dają dane strukturalne w sklepie
Dane Product pozwalają Google pokazać produkt w wynikach z ceną, dostępnością, oceną i informacją o dostawie, a także w panelu Zakupów Google, Grafice i wynikach z popularnymi produktami. Tak Google pokazuje to na przykładzie w swojej dokumentacji:

Dane strukturalne nie są czynnikiem rankingowym, który podnosi pozycję strony. Dają wynik, który więcej mówi kupującemu, a w wynikach produktowych i w zakupach przez AI decydują o tym, czy Twoja oferta w ogóle ma szansę się pokazać. Szerzej o samych znacznikach Schema.org piszę w przewodniku po danych strukturalnych.
Czy potrzebujesz danych strukturalnych, skoro masz Merchant Center - pierwsza decyzja
To najczęstsze pytanie. Odpowiedź Google: najlepiej oba. Feed w Merchant Center i dane na stronie się uzupełniają, a nie zastępują.
| Rozwiązanie | Co daje | Czego nie zrobi | Kiedy wystarczy samo |
|---|---|---|---|
| Feed w Merchant Center | Karta Zakupy, darmowe wyniki produktowe, reklamy; Google może brać z niego cenę, gdy nie ma jej na stronie | Nie opisze strony dla innych wyszukiwarek i asystentów AI, którzy czytają kod strony | Nigdy w pełni - Google zaleca oba |
| Dane strukturalne Product na stronie | Wyniki rozszerzone w wyszukiwarce, weryfikacja feedu ze stroną, dane dla innych robotów | Nie wpuści produktów do karty Zakupy - do tego potrzebny jest Merchant Center | Sklep, który nie korzysta z karty Zakupy i reklam produktowych |
| Oba naraz | Największe szanse na wszystkie formaty wyników | - | Zalecane dla każdego sklepu |
Google pisze wprost, że podanie danych na stronie i feedu w Merchant Center maksymalizuje szanse na wyświetlanie. Jak skonfigurować sam Merchant Center, opisuję we wpisie o SEO i GEO dla e-commerce.

Krótki opis produktu czy informacje od sprzedawcy
Google rozróżnia dwa rodzaje wyników produktowych i od tego zależy, które pola są wymagane.
| Format | Dla jakich stron | Wymagane | Uwagi |
|---|---|---|---|
| Informacje o produktach od sprzedawcy (merchant listing) | Strony, na których można kupić produkt | name, image, offers z price (większą od zera) i priceCurrency | To jest format dla sklepu |
| Krótki opis produktu (product snippet) | Strony, na których nie można kupić produktu: recenzje, porównania, rankingi | name i jedno z: review, aggregateRating, offers | Format dla blogów i serwisów z recenzjami |
Karta produktu w sklepie spełniająca wymagania merchant listing jest też uprawniona do krótkiego opisu produktu, więc sklep nie musi dodawać niczego osobno.
Product, Offer i Organization - które pola są wymagane

| Pole | Gdzie | Wymagane | Praktyczna uwaga |
|---|---|---|---|
| name | Product | Tak | Ta sama nazwa co w H1, bez dopisków typu „promocja” |
| image | Product | Tak | Zdjęcie produktu, nie logo ani baner |
| offers.price | Offer | Tak (większa od 0) | Liczba z kropką: 149.99, bez „zł” i spacji |
| offers.priceCurrency | Offer | Tak | PLN w formacie ISO 4217 |
| offers.availability | Offer | Zalecane | InStock, OutOfStock, PreOrder, BackOrder, Discontinued i inne; jedna wartość |
| itemCondition | Offer | Zalecane | NewCondition dla nowych produktów |
| gtin / gtin13 | Product | Zalecane | Kod EAN z opakowania; najbardziej szczegółowy, jaki masz |
| brand.name | Product | Zalecane | Marka producenta, nie nazwa sklepu |
| sku, mpn | Product | Zalecane | Własny kod sklepu i kod producenta |
| aggregateRating, review | Product | Zalecane | Tylko prawdziwe opinie widoczne na stronie |
| shippingDetails, hasMerchantReturnPolicy | Offer albo Organization | Zalecane | Najlepiej raz w Organization, patrz niżej |
Zwroty i dostawa: na karcie produktu czy raz dla sklepu
Google zaleca opisanie standardowych zasad zwrotów i dostawy raz, w znacznikach Organization (MerchantReturnPolicy i ShippingService), a na poziomie Offer tylko wyjątków dla konkretnych produktów. Gdy te same informacje są w kilku miejscach, Google bierze je w tej kolejności, od najsilniejszego:
- 1.Content API for Shopping,
- 2.ustawienia w Merchant Center albo Search Console,
- 3.znaczniki na poziomie produktu (Offer),
- 4.znaczniki na poziomie Organization.
Praktyczny wniosek: jeśli masz zasady zwrotów i dostawy ustawione w Merchant Center albo w Search Console, to one wygrywają i nie musisz ich powielać na każdej karcie. Jeśli nie masz, dodaj je raz w Organization na stronie głównej - to kilka linijek zamiast tysięcy powtórzeń.
Warianty produktu: ProductGroup
Rozmiary i kolory jednego modelu opisuje się przez ProductGroup: grupa ma productGroupID (kod produktu nadrzędnego) i variesBy (po czym różnią się warianty), a w hasVariant są poszczególne produkty z własnym SKU lub GTIN, ceną i dostępnością.

| Układ | Kiedy | Wymagania Google |
|---|---|---|
| Jedna strona dla wszystkich wariantów | Rozmiar i kolor wybierane na jednej karcie | Jeden kanoniczny adres grupy; każdy wariant da się wybrać parametrem w adresie, np. ?kolor=czarny&rozmiar=38 |
| Osobna strona dla każdego wariantu | Kolory z popytem i własnym adresem | Każda strona ma pełne znaczniki i powtarza definicję ProductGroup |
| Bez ProductGroup | Produkt bez wariantów albo warianty bez różnic w cenie i dostępności | Zwykły Product z Offer |
Przykład dla jednej strony z wariantami (skrócony do dwóch wariantów):
{ "@context": "https://schema.org", "@type": "ProductGroup", "name": "Buty trekkingowe Trek 12", "url": "https://twojsklep.pl/buty-trekkingowe-trek-12", "brand": { "@type": "Brand", "name": "Trek" }, "productGroupID": "BT12", "variesBy": ["https://schema.org/color", "https://schema.org/size"], "hasVariant": [ { "@type": "Product", "name": "Buty trekkingowe Trek 12 czarne 38", "sku": "BT12-CZ-38", "gtin13": "5901234123457", "color": "czarny", "size": "38", "image": "https://twojsklep.pl/img/bt12-czarne.jpg", "offers": { "@type": "Offer", "url": "https://twojsklep.pl/buty-trekkingowe-trek-12?kolor=czarny&rozmiar=38", "price": 149.00, "priceCurrency": "PLN", "availability": "https://schema.org/InStock", "itemCondition": "https://schema.org/NewCondition" } }, { "@type": "Product", "name": "Buty trekkingowe Trek 12 czarne 39", "sku": "BT12-CZ-39", "color": "czarny", "size": "39", "image": "https://twojsklep.pl/img/bt12-czarne.jpg", "offers": { "@type": "Offer", "url": "https://twojsklep.pl/buty-trekkingowe-trek-12?kolor=czarny&rozmiar=39", "price": 149.00, "priceCurrency": "PLN", "availability": "https://schema.org/OutOfStock" } } ]}
Kody GTIN i SKU w przykładzie są umowne. W prawdziwym sklepie każdy wariant musi mieć unikalny identyfikator - Google wymaga tego wprost. O tym, kiedy wariant powinien mieć osobny, indeksowany adres, piszę we wpisie o indeksacji sklepu internetowego.

Okruszki (BreadcrumbList) i oceny
Okruszki: BreadcrumbList musi mieć co najmniej dwa elementy ListItem, każdy z position i name, a wszystkie poza ostatnim także z item (adresem). Google pokazuje ten element na komputerach. Okruszki w danych powinny odpowiadać okruszkom widocznym na stronie i ścieżce kategorii, do której produkt naprawdę należy.
Oceny i opinie: zakaz „opinii o samym sobie” dotyczy znaczników LocalBusiness i Organization - firma nie dostanie gwiazdek za opinie o sobie na własnej stronie. Opinie o produkcie na karcie produktu w sklepie są dozwolone, o ile pochodzą od kupujących, są widoczne na stronie i nie są fałszywe ani niejawnie opłacone.
JSON-LD czy microdata, w HTML czy przez JavaScript
| Sposób | Czy Google go odczyta | Zalecenie |
|---|---|---|
| JSON-LD w początkowym HTML | Tak, od razu | Zalecane - najłatwiejsze w utrzymaniu |
| Microdata w HTML | Tak | Działa, ale trudniej utrzymać spójność przy zmianach szablonu |
| JSON-LD dodawany przez JavaScript | Tak, po wyrenderowaniu strony | Google ostrzega, że dla Product może to oznaczać rzadsze i mniej niezawodne pobieranie danych zakupowych |
| JSON-LD z Google Tag Managera | Tak, po wyrenderowaniu | Ryzyko rozjazdu danych ze stroną; Google zaleca ostrożność |
Dla sklepu wniosek jest jeden: Product w początkowym HTML. Dodatkowy argument: wiele crawlerów asystentów AI nie wykonuje JavaScriptu, więc danych dodanych skryptem po prostu nie zobaczy.

Co pokazał mój audyt 19 polskich sklepów
Jak sprawdzałem: w listopadzie 2026 skrypt wylosował adresy produktów z map witryn 23 polskich sklepów (elektronika, drogerie, apteki, moda, książki, dom i ogród, zoologiczne) i otwierał je w przeglądarce Chromium. Stronę uznawał za kartę produktu, jeśli miała przycisk dodania do koszyka - niezależnie od znaczników. Z każdego sklepu brał dwie takie karty. Dla każdej odczytał dane JSON-LD po wyrenderowaniu i w surowym HTML, sprawdził cyfrę kontrolną kodu GTIN i porównał cenę w danych z cenami widocznymi na stronie. Pełne wyniki mam dla 36 kart w 19 sklepach.

| Co sprawdzałem | Wynik | Uwagi |
|---|---|---|
| Dane Product w JSON-LD | 17 z 19 sklepów | W 2 sklepach brak Product w JSON-LD; jeden ma tylko microdata |
| Product już w surowym HTML | 32 z 32 kart z danymi | Żaden sklep nie dodawał Product dopiero JavaScriptem |
| Kod GTIN | 9 z 19 sklepów | Wszystkie 18 znalezionych kodów miało poprawną cyfrę kontrolną |
| Stan produktu (itemCondition) | 12 z 19 | - |
| Koszt dostawy w danych | 8 z 19 | Na poziomie Offer; tylko 2 karty miały dostawę w Organization |
| Zasady zwrotów w danych | 7 z 19 | Część sklepów może mieć je w Merchant Center - tego nie sprawdzałem |
| Ocena produktu (aggregateRating) | 5 z 19 | Część sklepów pokazuje opinie bez znaczników |
| Okruszki BreadcrumbList | 14 z 19 | - |
| Warianty przez ProductGroup | 4 z 19 | jysk.pl, agatameble.pl, doz.pl, zooplus.pl |
| Cena w danych zgodna z ceną na stronie | 28 z 31 kart | 3 rozbieżności opisane w pułapce niżej |
Tak wyglądają poprawne dane w walidatorze Schema.org dla jednej z kart z audytu - Product z GTIN, SKU i stanem produktu w surowym HTML:

Wnioski: podstawy (Product, cena, zdjęcie, marka) ma prawie każdy duży sklep. Różnice są w danych, które pomagają wygrać porównanie: GTIN, dostawa i zwroty są w połowie sklepów albo rzadziej, a warianty przez ProductGroup opisują tylko 4 sklepy z 19. Ograniczenia: to dwie karty na sklep, a zasady zwrotów i dostawy mogły być ustawione w Merchant Center, którego nie widzę.
Ile to pracy - dwie skale
Szacunki z moich wycen (listopad 2026) dla wdrożenia danych w szablonach sklepu, bez przygotowania danych źródłowych (GTIN-ów, zdjęć).
| Założenie | Sklep A: 500 produktów, bez wariantów | Sklep B: 20 000 produktów z wariantami |
|---|---|---|
| Product i Offer w szablonie karty | 3-6 godz. | 6-12 godz. |
| Zwroty i dostawa w Organization | 1-2 godz. | 2-4 godz. (kilka metod dostawy, wyjątki) |
| ProductGroup dla wariantów | nie dotyczy | 10-20 godz. |
| BreadcrumbList | 1-2 godz. | 2-4 godz. |
| Testy na próbce i monitoring w Search Console | 2-3 godz. | 6-10 godz. |
| Razem | ok. 7-13 godz. | ok. 26-50 godz. |
Na platformach takich jak Shopify czy WooCommerce część danych dodaje motyw lub wtyczka, ale zwykle bez GTIN, dostawy, zwrotów i wariantów. Typowe braki w WooCommerce opisuję na stronie pozycjonowanie sklepu WooCommerce, a pełne wdrożenie danych w szablonach robię w ramach pozycjonowania sklepów internetowych.
Skrypt: sprawdź dane produktu na próbce kart
Skrypt pobiera listę adresów kart produktu, wyciąga Product z JSON-LD w HTML i sprawdza: wymagane pola, cenę większą od zera, walutę, dostępność, poprawność cyfry kontrolnej GTIN oraz to, czy cena z danych występuje wśród cen widocznych w treści strony.
# pip install requestsimport json, re, sysimport requestsdef blocks(html): for m in re.finditer(r'<script[^>]+application/ld\+json[^>]*>(.*?)</script>', html, re.S | re.I): try: data = json.loads(m.group(1)) except ValueError: yield {"_error": "niepoprawny JSON"}; continue stack = [data] while stack: x = stack.pop() if isinstance(x, list): stack.extend(x) elif isinstance(x, dict): yield x stack.extend(v for k, v in x.items() if k in ("@graph", "mainEntity") and isinstance(v, (list, dict)))def gtin_ok(code): d = re.sub(r"\D", "", str(code)) if len(d) not in (8, 12, 13, 14): return False s = sum(int(c) * (3 if i % 2 == 0 else 1) for i, c in enumerate(reversed(d[:-1]))) return (10 - s % 10) % 10 == int(d[-1])for url in [u.strip() for u in open(sys.argv[1]) if u.strip()]: html = requests.get(url, headers={"User-Agent": "Mozilla/5.0"}, timeout=20).text text = re.sub(r"<[^>]+>", " ", html) prods = [b for b in blocks(html) if b.get("@type") in ("Product", "ProductGroup")] if not prods: print("BRAK Product w HTML:", url); continue p = prods[0] if p.get("@type") == "ProductGroup" and p.get("hasVariant"): p = p["hasVariant"][0] offer = p.get("offers") or {} offer = offer[0] if isinstance(offer, list) else offer problems = [f for f in ("name", "image") if not p.get(f)] price = offer.get("price") if not price or float(price) <= 0: problems.append("cena brak albo 0") if not offer.get("priceCurrency"): problems.append("brak waluty") if not offer.get("availability"): problems.append("brak dostępności") gtin = next((p[k] for k in ("gtin13", "gtin", "gtin14", "gtin12", "gtin8") if p.get(k)), None) if gtin and not gtin_ok(gtin): problems.append(f"zła cyfra kontrolna GTIN {gtin}") if price: shown = {f"{float(price):.2f}".replace(".", ","), f"{float(price):.2f}"} if not any(s in text for s in shown): problems.append(f"cena {price} nie występuje w treści strony") print("OK" if not problems else "PROBLEMY", url, "; ".join(problems))
Uwaga: skrypt czyta surowy HTML, więc ceny wstawiane na stronę JavaScriptem mogą dać fałszywy alarm przy porównaniu cen. Wtedy sprawdź kartę ręcznie albo użyj przeglądarki bez interfejsu (np. Playwright), tak jak w moim audycie.
Pułapka produkcyjna: cena w danych inna niż na stronie
W 3 z 31 kart z audytu cena w danych nie zgadzała się z ceną, którą widział kupujący. We wszystkich trzech przypadkach dane i widoczna cena najwyraźniej pochodzą z różnych miejsc w sklepie.
| Sklep | Cena w danych | Cena na stronie | Prawdopodobna przyczyna |
|---|---|---|---|
| zooplus.pl | 20,77 zł | 25,96 zł (wybrany wariant) | Dane podają cenę innego wariantu niż ten wybrany na stronie |
| ezebra.pl | 89,00 zł | 69,99 zł | Dane mają cenę regularną, strona pokazuje promocyjną |
| doz.pl | 51,99 zł | 59,79 zł | Dane podają inną cenę niż widoczna; przyczyny nie ustaliłem z zewnątrz |
Google zastrzega, że może weryfikować dane produktowe przed wyświetleniem ich w wynikach, a przy danych dodawanych przez Tag Managera ostrzega przed ryzykiem rozjazdu treści strony i znaczników. Rozjazd ceny to prosta droga do odrzuconych ofert w Merchant Center i do wyniku, który obiecuje inną cenę niż koszyk.
Poprawka: cena w JSON-LD musi pochodzić z tego samego źródła i tej samej logiki co cena wyświetlana - z ceną promocyjną włącznie. Przy wariantach Offer musi dotyczyć wariantu, który jest wybrany pod danym adresem. Dodaj test w szablonie albo w monitoringu (skrypt wyżej), który porównuje obie ceny na próbce kart po każdej zmianie cennika.
Czego nie robić
- Nie wpisuj w price ceny z „zł” albo spacjami - tylko liczba z kropką, waluta osobno w priceCurrency.
- Nie podawaj ceny 0 dla produktów niedostępnych - użyj availability: OutOfStock.
- Nie dodawaj danych tylko przez Tag Managera albo skrypt po załadowaniu strony.
- Nie powielaj zasad zwrotów i dostawy na tysiącach kart, jeśli możesz je podać raz w Organization albo w Merchant Center.
- Nie oznaczaj ocen, których nie ma na stronie, i nie wymyślaj opinii.
- Nie dawaj wszystkim wariantom tego samego SKU - każdy wariant potrzebuje unikalnego identyfikatora.
- Nie wpisuj GTIN-ów bez sprawdzenia cyfry kontrolnej.
FAQ
Kolejność wszystkich prac w sklepie opisuję w strategii SEO dla sklepu internetowego. Jeśli chcesz, żebym sprawdził dane strukturalne w Twoim sklepie i wdrożył poprawki w szablonach, zobacz pozycjonowanie sklepów internetowych.
Usługi powiązane z tym tematem
Potrzebujesz wdrożenia tych koncepcji? Zobacz usługi powiązane z tym tematem.
Źródła
- 01Google Search Central - Introduction to Product structured data
- 02Google Search Central - Merchant listing (Product, Offer) structured data
- 03Google Search Central - Product snippet structured data
- 04Google Search Central - Product variant structured data (ProductGroup, Product)
- 05Google Search Central - Merchant return policy structured data
- 06Google Search Central - Merchant shipping policy structured data
- 07Google Search Central - Breadcrumb structured data
- 08Google Search Central - Review snippet structured data
- 09Google Search Central - Generate structured data with JavaScript
- 10Schema.org Validator
- 11Vercel - The rise of the AI crawler (December 2024)
Powiązane artykuły
Paginacja w sklepie internetowym - canonical, noindex, „Załaduj więcej” czy infinite scroll (audyt polskich sklepów)
Jak ustawić paginację kategorii, żeby Google znalazł wszystkie produkty: paginacja, „Załaduj więcej” czy infinite scroll, canonical i noindex na stronach 2+, rel=next, tytuły, adresy stron, filtry, audyt polskich sklepów, skrypt i najczęstsze błędy.
Indeksacja sklepu internetowego - dlaczego Google nie indeksuje produktów i kategorii i jak to naprawić
Dlaczego Google nie indeksuje produktów i kategorii: statusy z Search Console przełożone na przyczyny w sklepie, „Wykryto” czy „Zeskanowano - obecnie nie zindeksowano”, produkty niedostępne i wycofane, warianty, mapy witryn 30 polskich sklepów, skrypt URL Inspection API i pułapka z lastmod.
Filtry w sklepie internetowym a SEO - które indeksować, a które blokować (noindex, canonical, robots.txt)
Które filtry w sklepie internetowym indeksować, a które blokować: reguła z progami, noindex vs canonical vs robots.txt vs nofollow w jednej tabeli, sprawdzenie filtrów w 11 polskich sklepach, ustawienia Shopify, WooCommerce, PrestaShop i IdoSell, liczba adresów przy dwóch skalach, robots.txt, skrypt i dwie pułapki.
Signal received?
Umów bezpłatną konsultację
Zainicjuj protokół. Nawiąż połączenie. Zbudujmy coś głośnego.
