Schema.org – co to jest, typy, formaty i przykład JSON-LD
Schema.org to wspólny słownik typów (np. Organization, Product, Article) i ich właściwości, którym opisuje się treść strony w danych strukturalnych. Założyły go w 2011 roku Google, Microsoft i Yahoo, a dziś rozwija go społeczność W3C. Kod zapisuje się zwykle w JSON-LD, który zaleca Google, a o tym, z których typów korzysta wyszukiwarka, decyduje dokumentacja Google, nie słownik.
Co to znaczy schema.org?
Schema.org to słownik: lista typów (firma, produkt, artykuł, wydarzenie, osoba) i właściwości, którymi się je opisuje. Rozwija go otwarta społeczność w grupie W3C. Korzystają z niego wyszukiwarki, e-maile i aplikacje.
Według Wikipedii słownik ogłosiły 2 czerwca 2011 Bing (Microsoft), Google i Yahoo, a Yandex dołączył w listopadzie 2011 (listopad 2011). Encyklopedia opiera te daty na wpisach z blogów Google i Bing.
Schema.org, dane strukturalne i wynik w Google to trzy różne rzeczy. Dane strukturalne to kod zapisany słownikiem na konkretnej stronie, a wynik z elementami rozszerzonymi (rich snippet) to jeden z możliwych efektów. Schema.org nie jest narzędziem Google ani odmianą JSON Schema czy XML Schema.
Jakie są znaczniki schema? Typy schema.org
Znaczniki schema to typy słownika schema.org ułożone w hierarchię, a każdy typ ma własny zestaw właściwości. Najogólniejszy typ Thing ma cztery właściwości: name, description, url i image. Typy szczegółowe dziedziczą właściwości typów ogólniejszych.
Według przewodnika schema.org LocalBusiness jest rodzajem Place i Organization, więc ma właściwości obu. Wartością bywa tekst, adres URL albo kolejny obiekt, np. address → PostalAddress. W firmie lokalnej te pola powtarzają dane NAP firmy.
Według strony „Schemas” słownik liczy 826 typów i 1540 właściwości w wersji 30.1 z 16.09.2026 (stan na 18 listopada 2026). Każdy typ ma własną stronę, np. schema.org/LocalBusiness. Najczęstsze grupy typów:
- dzieła:
CreativeWork,Article,Recipe, - organizacje i miejsca:
Organization,LocalBusiness, - osoby:
Person, - produkty i oferty:
Product,Offer, - opinie:
Review,AggregateRating, - wydarzenia:
Event.
Schema.org w JSON-LD i mikrodanych
Słownik schema.org zapisuje się w trzech formatach: JSON-LD, mikrodanych albo RDFa. JSON-LD to osobny blok skryptu typu application/ld+json w sekcji head lub body, poza widocznym tekstem. Mikrodane i RDFa to atrybuty dopisywane do znaczników HTML z widoczną treścią.
Google zaleca format najprostszy we wdrożeniu, a „w większości przypadków jest to format JSON-LD”. Poprawne formaty działają tak samo, a JSON-LD można wstawiać też JavaScriptem. Przykład (dane fikcyjne):
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Przykładowa Firma",
"url": "https://example.com/",
"logo": "https://example.com/logo.png",
"address": {
"@type": "PostalAddress",
"addressLocality": "Warszawa",
"addressCountry": "PL"
}
}
</script>@contextwskazuje słownik schema.org.@typepodaje typ, tuOrganization.name,url,logoto właściwości typu.addressto obiekt zagnieżdżony z własnym@type.
W mikrodanych ten sam opis otwiera itemscope itemtype="https://schema.org/Organization", a nazwę oznacza itemprop="name". Podstawowy JSON-LD generują same wtyczki SEO do WordPressa, więc ręczny blok tego samego typu może zdublować dane.
Jakie są dane strukturalne Google? Typy schema.org wykorzystywane w wyszukiwarce
Google wykorzystuje tylko część słownika schema.org, a źródłem wymagań jest Centrum wyszukiwarki Google (Search Central). Każda funkcja ma własne pola wymagane i zalecane.
Typy z galerii znaczników obsługiwanych przez Google (aktualizacja 20.10.2026, stan na 18 listopada 2026) zbiera tabela. Według wprowadzenia Google do danych strukturalnych stary słownik data-vocabulary.org nie jest już obsługiwany.
| Typ schema.org | Co pokazuje Google | Dla kogo |
|---|---|---|
| Article | artykuł | wydawcy, blogi |
| BreadcrumbList | menu nawigacyjne | serwisy z kategoriami |
| Event | wydarzenie | organizatorzy |
| LocalBusiness | firma działająca lokalnie | firmy z lokalem |
| Organization | logo i dane organizacji | każda firma |
| Product + Offer | produkt: cena, dostępność | sklepy |
| Recipe | przepis | serwisy kulinarne |
| Review, AggregateRating | fragment opinii | serwisy z recenzjami |
| VideoObject | film | serwisy wideo |
| JobPosting | oferta pracy | pracodawcy |
| FAQPage | nie wyświetla się od 7.05.2026 | brak |
Według changelogu Search Central wynik rozszerzony FAQ nie wyświetla się od 7 maja 2026, a w czerwcu Google usunął jego dokumentację. Wcześniej zniknęły m.in. ogłoszenia specjalne i ogłoszenia pojazdów. Typ FAQPage nadal istnieje w słowniku, a co z nim robić, opisuje rozdział o FAQPage po wycofaniu wyników FAQ.
Schema validator – test danych strukturalnych
Schema validator to w praktyce dwa narzędzia do dwóch różnych pytań. Test wyników z elementami rozszerzonymi (Google) sprawdza kwalifikację do funkcji Google i pola wymagane. Walidator schema.org sprawdza zgodność z całym słownikiem, bez wymagań Google.
- Test wyników z elementami rozszerzonymi: wykryte funkcje, błędy krytyczne blokujące kwalifikację i ostrzeżenia o polach zalecanych.
- Walidator schema.org: typy i właściwości spoza galerii Google.
- Raporty wyników z elementami rozszerzonymi w Search Console: stan znaczników po wdrożeniu.
Wtyczka i motyw potrafią wygenerować ten sam typ dwa razy, dlatego liczy się wynik testu, nie ustawienia. Poprawny kod nie gwarantuje wyświetlenia: według wytycznych Google forma wyniku zależy m.in. od lokalizacji i typu urządzenia.
Znaczniki muszą opisywać treść widoczną na stronie. Oznaczenie treści niewidocznej albo ocen spoza prawdziwych użytkowników grozi ręcznym działaniem. Według Google ręczne działanie odbiera wyniki rozszerzone, ale nie pozycję.
Najczęściej zadawane pytania
Google opisuje dane strukturalne jako pomoc w zrozumieniu treści i kwalifikację do wyników z elementami rozszerzonymi, nie jako czynnik rankingowy. Według wytycznych Google nawet ręczne działanie za błędne znaczniki nie zmienia pozycji. To, co dają dane strukturalne, opisuje hasło nadrzędne.
Google ich nie wymaga: w poradniku o generatywnej AI pisze, że dane strukturalne nie są wymagane w wynikach generatywnych i nie ma specjalnych znaczników schema.org dla AI. Zaleca je dalej w ramach SEO. Temat „dane strukturalne a AI” rozwija Akademia AI SEO.
Wynik rozszerzony FAQ nie wyświetla się w Google od 7.05.2026 według changelogu Search Central. Typ FAQPage nadal istnieje w słowniku schema.org i porządkuje pytania dla maszyn, więc usuwanie go nie jest konieczne. Szczegóły opisuje rozdział FAQPage po zmianach w Google.
Nie, dokumentacja schema.org jest po angielsku, a nazwy typów i właściwości zawsze zapisuje się po angielsku, np. Organization i name. Po polsku wpisuje się wartości: nazwę firmy, opis, adres, czyli treść w języku strony.