Schema Markup WordPress - dane strukturalne dla Google

Schema markup to dodatkowy kod, który tłumaczy robotom Google co dokładnie znajduje się na stronie. Człowiek widzi tekst, cenę i zdjęcie produktu. Robot widzi ciąg znaków – dopóki nie powiesz mu wprost, że to jest cena, a tamto autor artykułu.

Dane strukturalne opisuje słownik Schema.org, a w WordPress wdraża się je niemal zawsze w formacie JSON-LD. To skrypt umieszczony w sekcji `` lub na końcu strony, oddzielony od treści widocznej dla użytkownika. Google od lat oficjalnie rekomenduje JSON-LD zamiast starszych zapisów Microdata wplecionych w HTML – jest czytelniejszy i łatwiejszy do utrzymania.

Efektem poprawnie wdrożonego schema są tak zwane rich results (kiedyś zwane rich snippets): rozwijane pytania FAQ, gwiazdki ocen, cena i dostępność produktu, breadcrumbs zamiast surowego URL. Taki wynik zajmuje więcej miejsca w SERP i zwykle ma wyższy CTR niż zwykły niebieski link.

Ważny niuans, który ginie w większości poradników: schema nie jest bezpośrednim czynnikiem rankingowym. Google nie podnosi pozycji dlatego, że masz dane strukturalne. Korzyść jest pośrednia – wyższa klikalność i lepsze zrozumienie kontekstu strony. To rozróżnienie ratuje przed rozczarowaniem, gdy po wdrożeniu schema pozycja nie drgnie.

Schema.org można zapisać na trzy sposoby: JSON-LD, Microdata i RDFa. W WordPress odpowiedź jest prosta – używaj JSON-LD i nie zaprzątaj sobie głowy resztą.

Microdata i RDFa wplatają znaczniki bezpośrednio w HTML, mieszając opis danych z treścią widoczną na stronie. Działają, ale są kruche: każda zmiana w szablonie motywu grozi rozjechaniem znaczników, a kod robi się trudny do czytania. JSON-LD to oddzielny skrypt – żyje obok treści, nie w niej, więc nie psuje się przy edycji wyglądu.

Google od lat oficjalnie rekomenduje JSON-LD jako preferowany format i to właśnie jego generują Rank Math, Yoast oraz WooCommerce. Jeśli przejmujesz starszą stronę z Microdata wplecionym w HTML, najczęściej najlepiej jest stopniowo przejść na JSON-LD niż utrzymywać dwa konkurujące zapisy.

Schema.org definiuje setki typów, ale Google obsługuje rich results tylko dla wąskiej grupy. Wdrażanie typów, których wyszukiwarka nie renderuje, to strata czasu – kod będzie poprawny, ale w wynikach nic się nie pojawi.

Dla większości stron firmowych i blogów liczy się pięć, może sześć typów. Reszta to nisze (przepisy, kursy, oferty pracy, wydarzenia), które wdraża się tylko gdy strona faktycznie publikuje taką treść. Zanim dorzucisz egzotyczny typ, sprawdź w dokumentacji Google Search Central, czy w ogóle daje on wzbogacony wynik – inaczej wkładasz pracę w kod, którego nikt nie zobaczy.

Poniżej zestawienie typów, które realnie wykorzystujemy we wdrożeniach, wraz z tym, co dają w wynikach wyszukiwania:

Dwa typy warto omówić osobno, bo Google zmienił ich obsługę. FAQPage od połowy 2023 roku wyświetla się prawie wyłącznie dla stron rządowych i medycznych o uznanym autorytecie – zwykła firma rzadko zobaczy rozwijane pytania, choć sam kod nadal jest wartościowy dla zrozumienia treści. HowTo Google praktycznie wycofał z wyników, więc inwestowanie w niego pod kątem rich results nie ma już uzasadnienia.

Osobnej uwagi wymagają dwa typy tożsamościowe. Organization opisuje firmę jako podmiot – nazwę, logo, adres, profile w mediach społecznościowych – i bywa podstawą panelu wiedzy w Google. Person robi to samo dla autora treści i wspiera sygnały E-E-A-T, czyli wiarygodność osoby stojącej za artykułem. W praktyce Organization wdraża się raz dla całej witryny, a Person przypina do wpisów blogowych jako autora. Oba typy nie dają widocznego rich resultu na każdej stronie, ale budują tło, na którym Google i modele AI rozpoznają markę.

Są trzy drogi wdrożenia schema w WordPress: wtyczka SEO ogólnego przeznaczenia, dedykowana wtyczka do danych strukturalnych albo własny kod JSON-LD. Wybór zależy od wielkości strony, budżetu i tego, czy zależy Ci na pełnej kontroli.

Najprostsza ścieżka to wtyczka SEO, którą i tak masz już zainstalowaną. Rank Math i Yoast SEO generują podstawowe schema automatycznie – Article dla wpisów, Organization lub Person dla całej witryny, BreadcrumbList dla nawigacji. To pokrywa potrzeby zdecydowanej większości stron firmowych bez dodatkowej konfiguracji.

Warto wiedzieć, że obie wtyczki budują tak zwany graf danych (`@graph`) – łączą wszystkie obiekty schema na stronie w jedną, powiązaną strukturę zamiast luźno rozrzuconych skryptów. To czystsze rozwiązanie i jeden z powodów, dla których nie opłaca się dorzucać ręcznego JSON-LD obok wtyczki: rozbijasz graf, który wtyczka starannie złożyła.

Poniżej porównanie podejść, które stosujemy w zależności od projektu:

W Rank Math schema dodajesz tak: edytujesz wpis, otwierasz panel Rank Math, zakładkę Schema, klikasz Add Schema i wybierasz typ z listy. Pola autora, daty czy miniatury wtyczka mapuje sama z danych WordPress. W Yoast działa to przez ustawienia typu treści w sekcji Schema – wybierasz, czy strona ma być artykułem, stroną firmy czy czymś innym.

Ręczny JSON-LD ma sens, gdy potrzebujesz pełnej kontroli nad wyjściem. Prosty Article wpięty w `wp_head` wygląda tak:

add_action('wp_head', function () {
    if (!is_single()) return;
    $schema = [
        '@context' => 'https://schema.org',
        '@type' => 'Article',
        'headline' => get_the_title(),
        'datePublished' => get_the_date('c'),
        'dateModified' => get_the_modified_date('c'),
        'author' => [
            '@type' => 'Person',
            'name' => get_the_author(),
        ],
    ];
    echo '<script type="application/ld+json">'
        . wp_json_encode($schema, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)
        . '</script>';
});

Dla FAQ struktura jest równie prosta – tablica `mainEntity` z obiektami Question, z których każdy ma `acceptedAnswer`:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "Czy schema podnosi pozycje?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Nie bezposrednio, ale rich results podnosza CTR."
    }
  }]
}

Kluczowa zasada przy ręcznym kodzie: nie dubluj schema generowanego przez wtyczkę SEO. Jeśli Rank Math dodaje już Article, a Ty dorzucisz drugi w kodzie, Google zobaczy dwa konflikujące się obiekty na jednej stronie.

WooCommerce dodaje Product schema do kart produktów automatycznie i nie wymaga to żadnej dodatkowej wtyczki. W kodzie strony produktu znajdziesz cenę, walutę, dostępność i obrazek opisane zgodnie ze Schema.org.

Gwiazdki ocen pojawiają się, gdy włączysz recenzje w ustawieniach WooCommerce, a produkt zbierze przynajmniej jedną opinię. WooCommerce wstawia wtedy `aggregateRating` na podstawie realnych recenzji klientów.

Tu pojawia się najczęstszy błąd, który widzimy podczas audytów sklepów: wstawianie sztucznego `aggregateRating` na produkty bez recenzji albo na całą witrynę. Google traktuje to jako naruszenie wytycznych i potrafi nałożyć ręczną karę za spam danych strukturalnych. Gwiazdki muszą wynikać z faktycznych ocen wystawionych na tej stronie.

Do pełnego Product schema Google oczekuje też identyfikatorów produktu – GTIN, MPN lub marki. Czyste WooCommerce ich nie uzupełnia, więc dokłada się je albo dedykowaną wtyczką (Rank Math ma do tego pola Product w panelu produktu), albo własnym kodem mapującym atrybuty. Bez identyfikatorów karta produktu w Google będzie uboższa, a w Merchant Center pojawią się ostrzeżenia.

Drugi częsty kłopot to konflikt między WooCommerce a wtyczką SEO. Jeśli i WooCommerce, i Rank Math wystawiają Product schema dla tego samego produktu, na stronie pojawiają się dwa obiekty Product. Część wtyczek SEO ma przełącznik, który scala je w jeden graf – sprawdź to, zanim założysz, że wszystko działa. Po każdej zmianie cennika lub stanu magazynowego warto też przetestować pojedynczą kartę, bo to właśnie tam najczęściej rozjeżdża się cena w schema względem ceny widocznej na stronie.

Każde wdrożenie schema trzeba przetestować, zanim uznasz je za gotowe. Poprawny kod nie znaczy, że Google go zaakceptuje – walidacja pokazuje błędy i ostrzeżenia, których nie widać gołym okiem.

Dwa narzędzia, których używamy do weryfikacji:
- Rich Results Test (search.google.com/test/rich-results) – sprawdza, czy strona kwalifikuje się do konkretnego rich result i pokazuje, co Google wykrył.
- Schema Markup Validator (validator.schema.org) – waliduje składnię względem pełnego słownika Schema.org, także dla typów spoza rich results.

Po wdrożeniu warto też zaglądać do raportu Ulepszenia w Google Search Console. Pokazuje błędy schema na poziomie całej witryny, a nie pojedynczej strony – to jedyne miejsce, gdzie zobaczysz problem dotyczący setek podstron naraz.

Najczęstsze błędy, które wyłapujemy podczas audytów:

Najgroźniejszy jest błąd niezgodności: schema musi opisywać treść widoczną dla użytkownika. Jeśli oznaczysz FAQ, którego nie ma na stronie, albo cenę inną niż wyświetlana, Google potraktuje to jako próbę oszukania algorytmu. To dokładnie ten typ błędu, który prowadzi do ręcznych kar i jest najtrudniejszy do odwrócenia.

Warto rozróżnić w raportach dwa poziomy sygnałów. Błąd (error) oznacza, że strona straciła kwalifikację do rich resultu i wymaga natychmiastowej reakcji. Ostrzeżenie (warning) dotyczy pól zalecanych, nie wymaganych – strona nadal się kwalifikuje, ale uzupełnienie ich daje pełniejszy wynik. W praktyce naprawiamy najpierw wszystkie błędy, a ostrzeżenia traktujemy jako listę usprawnień do zrobienia przy okazji.

W naszych wdrożeniach najczęściej widzimy dwa skrajne podejścia do schema – i oba szkodzą. Pierwsze to strony zupełnie bez danych strukturalnych, gdzie sam fakt aktywacji Rank Math z domyślnymi ustawieniami od razu domyka podstawy. Drugie, groźniejsze, to nadgorliwe wstawianie sztucznych ocen i FAQ, których nie ma na stronie – w nadziei na gwiazdki w wynikach. To prosta droga do ręcznej kary za spam danych strukturalnych. Zasada, którą powtarzamy klientom: schema opisuje to, co realnie widzi użytkownik. Nic ponad to.

Dane strukturalne przestały dotyczyć wyłącznie klasycznych wyników Google. Asystenci AI i przeglądy generowane przez modele językowe coraz częściej sięgają po schema, by zrozumieć i zacytować treść strony.

Gdy ChatGPT, Perplexity czy Google AI Overviews składają odpowiedź, czysty, jednoznaczny opis strony ułatwia im wyłuskanie faktów: kto jest autorem, jaka jest cena, co firma oferuje. Strona bez schema nie znika z radaru, ale strona z poprawnym schema podaje te informacje na tacy, zamiast zmuszać model do zgadywania z treści.

To realna przewaga przy budowaniu widoczności w erze wyszukiwania opartego na AI. Organization i Person pomagają modelom powiązać markę z konkretną tożsamością, a Article jasno przypisuje treść do autora i daty. Tego aspektu prawie nie ma w polskich poradnikach o schema – większość zatrzymuje się na rich results w klasycznym SERP.

Nie znaczy to, że schema gwarantuje cytowanie przez AI – żaden model tego nie obiecuje, a dane strukturalne to jeden z wielu sygnałów. Ale logika jest spójna z klasycznym SEO: im mniej model musi zgadywać, tym pewniej oprze odpowiedź na Twojej treści. Dlatego te same typy, które domykasz pod Google – Article, Organization, Product – pracują podwójnie, raz na rich results, raz na czytelność dla modeli językowych.

Nie zaczynaj od wdrażania wszystkiego naraz. Najwięcej daje pokrycie podstaw, które działają na każdej stronie, a dopiero potem typy specyficzne dla Twojej treści.

Kolejność, którą stosujemy we wdrożeniach:
1. Upewnij się, że Rank Math lub Yoast generuje Article, Organization i BreadcrumbList – to fundament dla całej witryny.
2. Dla firm lokalnych dodaj LocalBusiness z adresem, godzinami i telefonem.
3. W sklepie sprawdź, czy WooCommerce poprawnie wystawia Product, i uzupełnij identyfikatory.
4. Przetestuj reprezentatywne strony w Rich Results Test.
5. Monitoruj raport Ulepszenia w Search Console przez kilka tygodni.

Dla firm, które wolą oddać techniczną stronę specjalistom, dane strukturalne to standardowy element naszych wdrożeń. Konfigurujemy je przy budowie stron internetowych i traktujemy jako fundament dalszej pracy nad pozycjonowaniem SEO – bez poprawnego schema trudniej walczyć o rich results i widoczność w AI.

Nie wiesz, czy Twoja strona ma poprawnie wdrożone dane strukturalne? Umów bezpłatną konsultację – sprawdzimy aktualny stan schema i wskażemy, co warto poprawić.