Dane strukturalne Schema.org dla produktów — pełny poradnik z przykładami

O czym jest ten poradnik

• Czym jest Schema.org i po co jest mikroformatowanie
• Jaki format używać (JSON-LD)
• Obowiązkowe i zalecane pola dla karty produktu
• Krok po kroku: od prostego do zaawansowanego przykładu
• Sprawdzanie, narzędzia i rekomendacje
• Szczegóły dla platform e-commerce

1. Czym jest Schema.org i po co?

Schema.org to słownik (vendor-neutral) dla danych strukturalnych, wspierany przez największe wyszukiwarki. Mikroformatowanie pomaga wyszukiwarkom poprawnie rozumieć treść karty produktu i może prowadzić do rozszerzonych snippetów (cena, dostępność, ocena, zdjęcia).

Oficjalne linki (zalecane):

• Google — Product structured data
• Schema.org — Product
• Schema.org — Offer

2. Jaki format rozważyć

Google zaleca JSON-LD. Nie ingeruje w DOM, łatwo go wstawić po stronie serwera i dynamicznie generować z bazy danych.

Dostępne formaty: JSON-LD (zalecany), Microdata, RDFa — wybierz JSON-LD dla sklepu internetowego.

3. Obowiązkowe pola dla poprawnej karty produktu

Minimum potrzebne dla poprawnej obsługi przez Google:

• name — nazwa produktu
• image — co najmniej jedno zdjęcie (URL)
• description — krótki opis
• offers.price — cena
• offers.priceCurrency — waluta (kod ISO, np. PLN, USD)
• offers.availability — dostępność (https://schema.org/InStock itp.)
• offers.url — URL strony produktu

4. Zalecane dodatkowe pola

• sku — kod produktu
• mpn — numer części producenta
• gtin8 / gtin12 / gtin13 / gtin14 — kod kreskowy
• brand — marka
• category — kategoria
• color, material, size, weight — cechy produktu
• aggregateRating — ocena zbiorcza
• review — recenzje
• itemCondition — stan produktu
• additionalProperty — własne właściwości (PropertyValue)
• shippingDetails / OfferShippingDetails — warunki wysyłki
• seller — sprzedawca

5. Prosty przykład JSON-LD (minimum)

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Słuchawki bezprzewodowe X100" nazwa produktu,
  "image": "https://site.com/images/headphones-x100.jpg" URL głównego zdjęcia,
  "description": "Bezprzewodowe słuchawki z redukcją szumów." krótki opis,
  "offers": {
    "@type": "Offer",
    "url": "https://site.com/product/headphones-x100" strona produktu,
    "priceCurrency": "PLN" waluta (ISO),
    "price": "2499" cena — liczba,
    "availability": "https://schema.org/InStock" dostępność
  }
}
</script>

price — wysyłaj jako liczbę/cyfry (bez symbolu waluty). availability używaj pełnego URL z schema.org.

6. Szczegółowy przykład produktu

Poniżej pełna struktura z GTIN, marką, SKU, kilkoma zdjęciami, aggregateRating, review, additionalProperty, shippingDetails.

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Xiaomi Mi Band 7",
  "image": [
    "https://site.com/upload/mi-band-7-1.webp",
    "https://site.com/upload/mi-band-7-2.webp"
  ],
  "description": "Opaska fitness z ekranem AMOLED i pulsomierzem.",
  "sku": "MI-BAND-7-BLACK",
  "mpn": "MB7-2025",
  "gtin13": "6954176850021",
  "brand": {
    "@type": "Brand",
    "name": "Xiaomi"
  },
  "additionalProperty": [
    {
      "@type": "PropertyValue",
      "name": "Kolor",
      "value": "Czarny"
    },
    {
      "@type": "PropertyValue",
      "name": "Materiał",
      "value": "Silikon, metal"
    }
  ],
  "offers": {
    "@type": "Offer",
    "url": "https://site.com/product/mi-band-7/",
    "priceCurrency": "PLN",
    "price": "1499",
    "priceValidUntil": "2026-12-31",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition",
    "seller": {
      "@type": "Organization",
      "name": "Hotlist.biz"
    },
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": {
        "@type": "MonetaryAmount",
        "value": "50"
      }
    }
  },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.8",
    "reviewCount": "238"
  },
  "review": [
    {
      "@type": "Review",
      "author": "Olena",
      "datePublished": "2025-02-10",
      "reviewBody": "Świetna opaska, działa stabilnie!",
      "reviewRating": {
        "@type": "Rating",
        "ratingValue": "5"
      }
    }
  ]
}
</script>

7. Produkty wariantowe (rozmiar/kolor)

1. Jeden główny Product + lista offers dla wariantów.
2. Kilka produktów Product na osobną stronę wariantu, jeśli każdy wariant ma własny URL.

8. BreadcrumbList (okruszki) — pomocne dla nawigacji

<script type="application/ld+json">
{
  "@context":"https://schema.org",
  "@type":"BreadcrumbList",
  "itemListElement":[
    {
      "@type":"ListItem",
      "position":1,
      "name":"Strona główna",
      "item":"https://site.com/"
    },
    {
      "@type":"ListItem",
      "position":2,
      "name":"Kategoria: Opaski",
      "item":"https://site.com/category/bracelets"
    },
    {
      "@type":"ListItem",
      "position":3,
      "name":"Xiaomi Mi Band 7",
      "item":"https://site.com/product/mi-band-7/"
    }
  ]
}
</script>

9. Sprawdzanie rozmiaru — narzędzia

• Google Rich Results Test
• Schema.org Validator
• Google Search Console — w sekcji „Udoskonalenia” → „Produkty” monitoruj błędy po publikacji.

10. Best practices i wskazówki

• Generuj JSON-LD po stronie serwera z bazy danych — cena, dostępność, sku, zdjęcia muszą być zsynchronizowane z treścią strony.
• Nie używaj testowych/fikcyjnych danych w produkcji.
• Jeśli pokazujesz kilka cen (promocje), użyj priceValidUntil.
• Używaj priceCurrency w formacie ISO (PLN, USD, EUR).
• Nie twórz sprzecznych danych (różne ceny w treści i JSON-LD).
• Dla sklepów międzynarodowych podawaj lokalizację, adres sprzedawcy i shippingDetails.

11. Najczęstsze błędy i poprawki

• Błąd: price zawiera symbol waluty — poprawka: używaj tylko liczb
• Błąd: brak image — poprawka: dodaj co najmniej jeden poprawny URL
• Błąd: różne URL — poprawka: używaj URL bieżącej strony w offers.url
• Błąd: fałszywe review/aggregateRating — poprawka: pokazuj tylko rzeczywiste recenzje

12. SEO wskazówki

• Dodaj dane strukturalne do każdej karty produktu — zwiększa szanse na rich snippet.
• Dodaj szczegółowe zdjęcia (ImageObject) z width/height jeśli możliwe.
• Używaj BreadcrumbList i Product razem — poprawia nawigację w wynikach wyszukiwania.
• Monitoruj Google Search Console i poprawiaj błędy rozmiaru.