Poradniki · E-commerce
Dane strukturalne Product: fragmenty produktu i Merchant Listing w praktyce
Dane strukturalne Product krok po kroku: czym fragment produktu różni się od merchant listing, jak opisać ofertę, ceny i opinie oraz jak to sprawdzić.
Redakcja SEO Maestro20.11.20267 min czytaniaźródła sprawdzone 20.11.2026
Masz kartę produktu z ceną, stanem magazynowym i opiniami klientów. Człowiek odczyta to od razu. Wyszukiwarka musi zgadywać, która liczba jest ceną, a która numerem katalogowym. Dane strukturalne Product podają jej te informacje wprost. Musisz tylko wiedzieć, czy opisujesz stronę sprzedaży, czy stronę recenzji, bo Google traktuje je jako dwa osobne przypadki.
Dwie ścieżki: sklep i recenzja
Google opisuje znacznik Product w dwóch dokumentach i każdy z nich zaczyna od pytania, kim jesteś.
Merchant listing dotyczy stron, na których klient może kupić produkt. Taka strona może pojawić się w panelu wiedzy zakupowej, w Grafice Google, w wynikach popularnych produktów i we fragmentach produktu. Merchant listing pokazuje więcej szczegółów o samej sprzedaży: cenę, dostępność oraz informacje o wysyłce i zwrotach.
Fragment produktu (product snippet) to wynik tekstowy wzbogacony o oceny, informacje z recenzji, cenę i dostępność. Google kieruje go przede wszystkim do redakcyjnych stron z recenzjami, czyli testów, porównań i omówień produktów, których autor sam nie sprzedaje.
Dokumentacja odsyła w obie strony. Na stronie o fragmentach produktu Google pyta, czy klienci mogą kupić u ciebie produkt, i jeśli tak, poleca znacznik merchant listing. Na stronie o merchant listing pyta z kolei, czy masz redakcyjne strony recenzji, i dla nich poleca fragmenty produktu.
Różnicę dobrze widać w przykładach Google. Wersja dla recenzji może zawierać wyłącznie nazwę, opis, recenzję i średnią ocen, bez żadnej oferty. Wersja dla sklepu zawsze ma obiekt offers z ceną, walutą i dostępnością. Recenzja opisuje rzecz, a sklep opisuje także warunki jej zakupu.
| Cecha | Fragment produktu | Merchant listing |
|---|---|---|
| Dla kogo | strony z recenzjami redakcyjnymi | strony, na których można kupić produkt |
Oferta (offers) | może jej nie być | jest podstawą znacznika |
| Gdzie może się pojawić | wynik tekstowy z ocenami, ceną, dostępnością | panel zakupowy, Grafika Google, popularne produkty, fragmenty produktu |
| Dodatkowe dane | zalety i wady recenzenta | cena przekreślona, cena członkowska, wysyłka, zwroty |
Sklep, który ma także bloga z testami sprzętu, potrzebuje obu wariantów: merchant listing na kartach produktów i fragmentów produktu na stronach testów.
Pola, z których składa się produkt
Zacznij od słownika. Według schema.org Product to „każdy oferowany produkt lub usługa”: para butów, bilet na koncert, wynajem auta, strzyżenie. Typ ma kilkadziesiąt właściwości. Na karcie sklepu najczęściej przydadzą ci się te:
name,description,image: nazwa, opis i zdjęcia. Google w przykładzie podaje trzy wersje zdjęcia w proporcjach 1:1, 4:3 i 16:9.brand: marka jako obiekt Brand albo Organization.skuimpn: twój kod magazynowy i numer części nadany przez producenta.gtin: globalny numer towaru, u nas zwykle kod EAN z opakowania. Schema.org wymaga, żeby był to ciąg samych cyfr o długości 8, 12, 13 albo 14, z poprawną cyfrą kontrolną. Nie dopisuj zer z lewej strony.offers: oferta sprzedaży, o niej w następnej sekcji.aggregateRatingireview: średnia ocen i pojedyncze recenzje.hasMerchantReturnPolicy: zasady zwrotów.
Które pola są obowiązkowe, a które tylko zalecane, Google wymienia w tabelach właściwości osobno dla merchant listing i dla fragmentów produktu. Sprawdzaj te tabele przed każdym wdrożeniem, a nie listę z artykułu sprzed roku. Wymagania się zmieniają, a test wyników z elementami rozszerzonymi i tak wskaże, czego brakuje.
Przykład dla karty produktu w sklepie:
<script type="application/ld+json">
{
"@context": "https://schema.org/",
"@type": "Product",
"name": "Stół dębowy Lipa 160",
"image": [
"https://przyklad.pl/zdjecia/1x1/lipa.jpg",
"https://przyklad.pl/zdjecia/4x3/lipa.jpg",
"https://przyklad.pl/zdjecia/16x9/lipa.jpg"
],
"description": "Stół z litego dębu, 160 x 90 cm, olejowany ręcznie w Pracowni Kowalski.",
"sku": "LIPA-160",
"mpn": "PK-160-D",
"brand": {
"@type": "Brand",
"name": "Pracownia Kowalski"
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": 4.7,
"reviewCount": 31
},
"offers": {
"@type": "Offer",
"url": "https://przyklad.pl/stol-lipa-160",
"priceCurrency": "PLN",
"price": 3490.00,
"itemCondition": "https://schema.org/NewCondition",
"availability": "https://schema.org/InStock"
}
}
</script>
Liczby w aggregateRating muszą wynikać z opinii widocznych na stronie. Średnia wpisana w kod, której klient nie zobaczy, to deklaracja bez pokrycia, a nie dane strukturalne.
Oferta, ceny i wysyłka
Obiekt Offer mówi, na jakich warunkach sprzedajesz. W przykładzie Google oferta ma adres strony (url), walutę (priceCurrency), cenę (price), stan towaru (itemCondition, na przykład NewCondition albo UsedCondition) i dostępność (availability, na przykład InStock). Opcjonalnie może mieć też datę ważności ceny (priceValidUntil).
Google rozróżnia trzy rodzaje cen:
- cena aktualna: kwota, za którą produkt kupisz teraz,
- cena przekreślona: wyższa cena regularna, pokazywana w czasie promocji obok niższej,
- cena członkowska: cena dla uczestników konkretnego programu lojalnościowego.
Cenę aktualną podajesz wprost w price albo w priceSpecification. Dwie pozostałe zapisujesz jako specyfikacje cen w obiekcie Offer. Cena przekreślona dostaje priceType o wartości StrikethroughPrice (w okresie przejściowym Google akceptuje też ListPrice). Cena członkowska dostaje właściwość validForMemberTier. Tych dwóch właściwości nie wolno łączyć w jednej specyfikacji. Google pomija specyfikację, która ma obie naraz, więc ten jeden błąd potrafi wyłączyć całą promocję.
Promocja z ceną przekreśloną może wyglądać tak:
"offers": {
"@type": "Offer",
"url": "https://przyklad.pl/stol-lipa-160",
"availability": "https://schema.org/InStock",
"priceSpecification": [
{
"@type": "UnitPriceSpecification",
"price": 2990.00,
"priceCurrency": "PLN"
},
{
"@type": "UnitPriceSpecification",
"priceType": "https://schema.org/StrikethroughPrice",
"price": 3490.00,
"priceCurrency": "PLN"
}
]
}
Wysyłkę i zwroty Google wymienia wśród danych, które merchant listing może pokazać. Zasady zwrotów opisuje w schema.org właściwość hasMerchantReturnPolicy. Szczegółową strukturę pól wysyłkowych, czyli koszt, strefy i czas dostawy, weź z aktualnej dokumentacji merchant listing. Nie przepisuj jej z forów, bo właśnie tu sklepy najczęściej kopiują nieaktualne wzory.
Dostępność i cena w kodzie muszą zmieniać się razem ze stanem magazynu. Jeśli wtyczka wpisała InStock przy wdrożeniu i od tamtej pory nikt tego nie aktualizuje, klient zobaczy w wynikach produkt, którego od miesiąca nie masz.
Opinie, zalety i wady na stronach recenzji
Jeśli piszesz testy produktów, fragment produktu pozwala pokazać coś, czego zwykły wynik nie ma: listę zalet i wad. Recenzja (Review) dostaje wtedy autora oraz dwie listy, positiveNotes i negativeNotes, zapisane jako ItemList z elementami ListItem:
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Szlifierka Kowalski S2",
"review": {
"@type": "Review",
"name": "Test szlifierki Kowalski S2",
"author": {
"@type": "Person",
"name": "Anna Nowak"
},
"positiveNotes": {
"@type": "ItemList",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "Równe szlifowanie dębu" },
{ "@type": "ListItem", "position": 2, "name": "Niska waga" }
]
},
"negativeNotes": {
"@type": "ItemList",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "Krótki przewód" }
]
}
}
}
Schema.org dopuszcza negativeNotes także bezpośrednio na produkcie, ale sam zauważa, że opisy produktów rzadko wymieniają wady. W praktyce te listy mają sens w recenzji, w której autor rzeczywiście coś przetestował. Jeśli chcesz pokazać to doświadczenie także w samej treści, przeczytaj poradnik o E-E-A-T.
Sprawdź kod w teście wyników z elementami rozszerzonymi
Google proponuje stałą kolejność: dodać właściwości, przestrzegać wytycznych, sprawdzić kod, opublikować kilka stron, obejrzeć je oczami Google i dopiero wtedy wdrażać szerzej. Zrób to dziś na jednej karcie produktu.
- Wybierz jeden produkt, który sprzedajesz, ma opinie i ma aktualną cenę.
- Otwórz kod strony i znajdź blok
application/ld+json. Jeśli go nie ma, sprawdź, czy twój CMS ma wtyczkę do danych strukturalnych. Google sam podpowiada, że to często najprostsza droga. - Porównaj kod z tym, co widzi klient: cena, waluta, dostępność i liczba opinii muszą się zgadzać co do grosza i sztuki.
- Wklej adres strony do testu wyników z elementami rozszerzonymi (Rich Results Test). Usuń błędy krytyczne. Ostrzeżenia nie blokują wyświetlania, ale ich poprawienie podnosi jakość danych, więc też się nimi zajmij.
- Sprawdź, czy narzędzie rozpoznało właściwy typ: merchant listing na stronie sprzedaży, fragment produktu na stronie recenzji.
- Po publikacji użyj narzędzia do sprawdzania adresów URL w Search Console i zobacz, jak Google widzi stronę. Upewnij się, że nie blokuje jej robots.txt, tag noindex ani wymóg logowania.
- Jeśli wszystko wygląda dobrze, poproś o ponowne zindeksowanie i dodaj stronę do mapy witryny. Licz się z tym, że Google może potrzebować kilku dni, żeby ją znaleźć i przetworzyć.
Jeśli dane generuje JavaScript, test pokaże, czy Google je odczytuje. Inne boty mogą sobie z tym radzić gorzej, o czym piszemy w poradniku o treści ładowanej JavaScriptem.
Poprawny wynik testu oznacza, że strona może się kwalifikować do wyników rozszerzonych. Nie oznacza, że Google je pokaże. Decyzję podejmuje wyszukiwarka i żadna dokumentacja tego nie gwarantuje. Masz wpływ na to, żeby dane były kompletne, prawdziwe i zgodne ze stroną.
Ten sam porządek przydaje się też poza Google. Jak opisać sklep w odpowiedziach asystentów AI, omawiamy w poradniku o sklepie internetowym w odpowiedziach AI. Dane o samej firmie opisuje poradnik o Organization i Article. Kod nie zastąpi strony, na której cena, stan i opinie są widoczne i aktualne. Pomaga tylko maszynie odczytać je bez zgadywania.
Źródła
- Google Search Central: Merchant listing (Product, Offer) structured data - miejsca wyświetlania, rodzaje cen, zasady
priceTypeivalidForMemberTieroraz procedura testowania. - Google Search Central: Product snippet (Product, Review, Offer) structured data - fragmenty produktu, przykłady dla stron recenzji oraz zalety i wady.
- Schema.org: Product - definicja typu i właściwości:
gtin,mpn,brand,offers,hasMerchantReturnPolicy,positiveNotes,negativeNotes.
Jeśli chcesz sprawdzić, czy asystenci AI cytują twoje strony produktów, gdy klienci pytają o twoją branżę, uruchom darmowy test SEO Maestro. Wynik dostaniesz po około półtorej minuty, bez zakładania konta.
Czytaj dalej
Jak działa wyszukiwarka Google: skanowanie, indeksowanie i AI
Jak działa wyszukiwarka Google: trzy etapy z dokumentacji, miejsce AI Overviews i AI Mode, czego Google nie gwarantuje i co sprawdzić na swojej stronie.
22.11.2026 · 8 minAdres kanoniczny (canonical): jedna wersja strony dla Google i AI
Adres kanoniczny krok po kroku: rel=canonical, przekierowania, sygnały Google, zasady RFC 6596 i typowe błędy w sklepach i na blogach.
21.11.2026 · 8 minRSS a boty AI: kanał RSS i Atom, który czytają wyszukiwarki
RSS a boty AI: jak zbudować poprawny kanał RSS 2.0 lub Atom, zgłosić go Google jako sitemap i powiadamiać o zmianach przez WebSub. Z przykładami kodu.