Schema markup w WordPress: poprawne dane i kontrola wdrożenia

Schema.org jest słownikiem typów i właściwości, a JSON-LD jednym ze sposobów zapisania danych. Robot wyszukiwarki potrafi analizować zwykły tekst bez schema. Dodatkowe oznaczenia precyzują jednak relacje: wskazują, że dana osoba jest autorem konkretnego artykułu, a cena dotyczy określonej oferty.

Nie buduj planu SEO na łańcuchu: dodamy schema, wzrośnie CTR, więc wzrosną pozycje. Każdy z tych efektów wymaga osobnej obserwacji, a samo wdrożenie nie daje gwarancji żadnego z nich. Google rozróżnia poprawne dane od kwalifikacji do konkretnego sposobu prezentacji i od faktycznego wyświetlenia wyniku.

W praktyce najpierw ustalasz, jakie informacje mają być prawdziwe i aktualne. Potem mapujesz je do modelu danych. Dopiero na końcu oceniasz możliwości wynikające z dokumentacji danej funkcji wyszukiwarki. To zadanie techniczne wspierające pozycjonowanie SEO, a nie zamiennik trafnej treści, dostępności strony czy jej wiarygodności.

Nie dodawaj ukrytych opinii, obietnic ani danych firmy, których nie można potwierdzić na stronie. Zielony wynik walidatora nie sprawdza, czy wpisana ocena naprawdę pochodzi od klientów.

JSON-LD umieszcza dane w osobnym skrypcie typu application/ld+json. Microdata i RDFa wiążą właściwości z elementami HTML. Istniejący poprawny zapis nie wymaga przebudowy wyłącznie z powodu formatu. Przy nowym wdrożeniu JSON-LD jest wygodny do utrzymania, lecz nadal może się zdezaktualizować względem widocznej treści.

Otwórz kod oraz wyrenderowany dokument przykładowego wpisu, produktu i strony firmowej. Wyszukaj skrypty JSON-LD, a także atrybuty starszych formatów. Zapisz typ, identyfikator @id, najważniejsze pola i prawdopodobny generator. Może nim być wtyczka SEO, WooCommerce, motyw, blok edytora albo własny fragment kodu.

Kilka skryptów na stronie nie oznacza automatycznie błędu. Article i BreadcrumbList mogą znajdować się osobno, a zgodne odwołania do jednej osoby łączyć się przez stabilne @id. Problem zaczyna się wtedy, gdy ta sama oferta ma dwie różne ceny albo artykuł dwóch sprzecznych autorów.

Zmiany generatorów sprawdzaj na stagingu. Wyłączenie całej wtyczki SEO może wpłynąć również na metadane, canonical i mapę witryny. Jeżeli potrzebujesz zmienić tylko schema, szukaj konfiguracji lub filtra o takim zakresie zamiast wyłączać wszystkie funkcje komponentu.

Typ dobieraj do zawartości konkretnego URL-a. Nie każdy ekran strony firmowej jest artykułem, a nie każda podstrona usługi reprezentuje osobną organizację. Zachowaj jeden spójny opis firmy i odwołuj się do niego tam, gdzie występuje jako wydawca lub podmiot usługi.

Dane Article w dokumentacji Google obejmują opis autora i publikacji. Nie usuwaj poprawnego Person ani widocznego autora tylko dlatego, że nie otrzymujesz osobnej karty tej osoby w wyszukiwarce. Dane tożsamościowe mają sens jako element relacji w dokumencie; nie są certyfikatem eksperckości.

Google zakończył FAQ rich results od 7 maja 2026 r., co podaje oficjalny changelog. Nie jest to już wyłącznie ograniczenie do stron zdrowotnych i administracji z 2023 roku. Zachowaj pomocne FAQ dla czytelnika, a istniejący zgodny zapis oceniaj pod kątem treści i utrzymania, bez obietnicy rozwijanych pytań w Google.

Najpierw sprawdź możliwości obecnego generatora. Dodatkowa wtyczka ma sens, gdy rozwiązuje konkretną lukę: mapuje wymagane pola lub obsługuje potrzebny model. Sam wzrost liczby typów nie jest zaletą. Ustal, który komponent odpowiada za każdą encję i jak będzie reagował na zmianę danych źródłowych.

Poniższy fragment pokazuje bezpieczne serializowanie prostego Article w WordPress. Jest przykładem dla programisty, nie kompletnym wdrożeniem gotowym do doklejenia obok istniejącego Article. W projekcie trzeba uzupełnić potrzebne pola i powiązania zgodnie z rzeczywistą publikacją.

add_action('wp_head', function () {
    if (!is_singular('post')) {
        return;
    }
    $post_id = get_queried_object_id();
    $author_id = (int) get_post_field('post_author', $post_id);
    $url = get_permalink($post_id);
    $schema = [
        '@context' => 'https://schema.org',
        '@type' => 'Article',
        '@id' => $url . '#article',
        'headline' => get_the_title($post_id),
        'datePublished' => get_the_date('c', $post_id),
        'dateModified' => get_the_modified_date('c', $post_id),
        'author' => [
            '@type' => 'Person',
            '@id' => get_author_posts_url($author_id) . '#person',
            'name' => get_the_author_meta('display_name', $author_id),
        ],
    ];
    $json = wp_json_encode(
        $schema,
        JSON_HEX_TAG | JSON_HEX_AMP | JSON_HEX_APOS | JSON_HEX_QUOT
    );
    if (false !== $json) {
        echo '<script type="application/ld+json">' . $json . '</script>';
    }
});

wp_json_encode serializuje strukturę danych, zamiast sklejać JSON ręcznie. Flagi kodujące znaki specjalne pomagają zachować granice skryptu osadzonego w HTML. Sprawdź tytuły zawierające cudzysłowy i ciąg zamykający skrypt oraz odczyt JSON z faktycznie wyrenderowanego dokumentu. Sam poprawny plik PHP nie potwierdza poprawnego DOM.

WooCommerce generuje dane produktu, ale końcowy zapis zależy także od motywu i rozszerzeń. Otwórz kartę produktu prostego i wariantowego. Porównaj cenę, walutę oraz dostępność z tym, co widzi klient. Szczególnie sprawdź promocję, wyprzedany wariant i zmianę ceny po aktualizacji cache.

Dokumentacja Product Google rozróżnia sposoby prezentacji produktów i ich wymagania. Poprawny kod daje możliwość kwalifikacji, nie gwarancję gwiazdek. Sama jedna opinia ani włączenie recenzji nie zobowiązuje wyszukiwarki do pokazania oceny. Nie dopisuj aggregateRating bez prawdziwych opinii, które odpowiadają opisywanemu produktowi.

Aktualna dokumentacja zarządzania produktami WooCommerce opisuje identyfikatory produktu. Nie zakładaj, że rdzeń zawsze wymaga dodatkowej wtyczki do wpisania GTIN. Sprawdź dostępne pola w używanej wersji i ich mapowanie do wyjściowego schema. GTIN nie zastępuj przypadkowym SKU: to identyfikatory o innym znaczeniu.

Dla wariantów ważne są relacje produktu nadrzędnego, sprzedawanej kombinacji i oferty. Google opisuje ProductGroup oraz warianty dla różnych architektur stron. Najpierw uporządkuj atrybuty i warianty WooCommerce, a potem odzwierciedl rzeczywisty model w danych. Nie zmieniaj adresów canonical wyłącznie w celu uproszczenia przykładu schema.

Wykonaj trzy osobne kontrole. Pierwsza dotyczy składni JSON i modelu Schema.org. Druga wymagań konkretnej funkcji Google. Trzecia porównania pól z treścią widoczną dla użytkownika. Żadne pojedyncze narzędzie nie rozstrzyga całej trójki.

Rich Results Test pokazuje obsługiwane przez Google typy i problemy z ich kwalifikacją. Schema Markup Validator pomaga sprawdzić również typy spoza tego zakresu. Brak osobnego wyniku dla Person w pierwszym narzędziu nie dowodzi, że osoba została błędnie opisana.

Ostrzeżenie o polu zalecanym nie jest tym samym co błąd wymaganej właściwości. Uzupełniaj pola, gdy masz prawdziwe dane, a nie po to, żeby usunąć kolorowe oznaczenie. Wynik testu zachowaj z adresem, datą i informacją, którą wersję strony sprawdzono.

Schema jest częścią działającej witryny. Aktualizacja motywu, generatora albo konfiguracji produktu może zmienić wynikowy kod bez edycji samego artykułu. Dlatego do procedury aktualizacji WordPress dodaj reprezentatywną próbkę: wpis z autorem, stronę firmową i kartę produktu.

Porównaj liczbę oraz typy encji, ich @id i najważniejsze relacje. Nie oczekuj identycznej kolejności kluczy JSON; znaczenie mają wartości i powiązania. Sprawdź widoczne FAQ oraz autora, a także to, czy inne elementy dokumentu nie zostały przypadkowo zamknięte przez błędnie osadzony przykład kodu.

Raporty Search Console pomagają obserwować wykryte problemy w skali witryny, lecz nie pokazują natychmiast każdej zmiany. Własny crawl i automatyczna kontrola próbek uzupełniają te dane. Wynik odbioru powinien nazywać poprawiony błąd, a nie deklarować przyszły wzrost ruchu.

Wytyczne Google dotyczące funkcji AI nie wymagają specjalnego schema ani osobnego pliku dla AI. Dane strukturalne powinny zgadzać się z widocznym tekstem, a ważne informacje muszą być dostępne dla odbiorcy. Nie przenoś tych zasad automatycznie na produkty wszystkich innych dostawców.

Praktyczna kontrola treści jest prosta: czy akapit samodzielnie odpowiada na pytanie, wskazuje warunki i podaje źródło? Czy autor oraz data są prawdziwe? Schema może opisać te elementy, ale nie zastąpi brakującej odpowiedzi. Samo pobranie strony przez bota nie dowodzi cytowania, a poprawne Person nie gwarantuje rozpoznania autora przez model.

Wybierz po jednym adresie z ważnych rodzin treści i zapisz stan wyjściowy. Ustal generatory, porównaj ich dane oraz przypisz właściciela każdej informacji. Najpierw usuń sprzeczne ceny, fałszywe oceny i błędne relacje; potem uzupełnij potrzebne pola oraz wykonaj testy.

Przy pracach nad WordPress traktuj schema jako element odbioru strony wraz z widoczną treścią. Jeśli potrzebujesz pomocy, prześlij adresy do sprawdzenia oraz opis oczekiwanego modelu. Zakres dalszej kontroli i ewentualny pakiet godzinowy ustalamy indywidualnie. Dobrym wynikiem pierwszego etapu jest lista konkretnych korekt oraz potwierdzenie ich działania, bez deklarowania terminu pojawienia się rozszerzonych wyników.