Generator schema.org

Generator schema.org – dane strukturalne w JSON-LD

Dane strukturalne pomagają wyszukiwarkom zrozumieć treść strony i wyświetlać rozszerzone wyniki (rich snippets): oceny, ceny, daty wydarzeń, dane firmy.

Generator schema.org zamienia wypełniony formularz na gotowy blok <script type="application/ld+json">. Wybierasz jeden z 9 typów, formularz pokazuje tylko pola, które są poprawnymi właściwościami tego typu, a pod kodem pojawia się tabela kontrolna: które właściwości wymagane i zalecane przez Google są w kodzie, a których brakuje.

Obsługiwane typy

Przykład

Po wejściu na stronę formularz zawiera przykład typu Article. Wynik wygląda tak (tu bez wcięć):

{"@context": "https://schema.org", "@type": "Article", "name": "Jak zbudować stronę w 10 minut", "headline": "Jak zbudować stronę w 10 minut", "description": "Praktyczny poradnik dla początkujących.", "url": "https://example.com/poradnik", "image": "https://example.com/img/poradnik.jpg", "author": {"@type": "Person", "name": "Jan Kowalski"}, "publisher": {"@type": "Organization", "name": "Example Sp. z o.o."}}

Dla artykułu tytuł trafia jednocześnie do name i headline, bo Google zaleca właśnie headline. Pole daty jest w tym przykładzie puste, więc datePublished nie pojawia się w kodzie, a kontrola pokazuje 3 z 4 zalecanych właściwości.

Jak wdrożyć

Skopiuj kod przyciskiem „Kopiuj kod” i wklej w sekcji <head> lub w treści podstrony, której dotyczy. Jeśli CMS sam dodaje znacznik script (np. pole na dane strukturalne we wtyczce SEO), użyj opcji „Kopiuj sam JSON”. Zweryfikuj kod w teście wyników z elementami rozszerzonymi (Rich Results Test), a po wdrożeniu śledź błędy w raportach wyników rozszerzonych w Search Console.

Jak działa generator danych strukturalnych

Narzędzie nie skanuje Twojej strony i nie pobiera z niej treści. Działa jak formularz, który zamienia wpisane wartości na obiekt JSON-LD. Dwa elementy wyniku są zawsze stałe: @context ustawiony na https://schema.org oraz @type wybranego typu. Puste pola nie trafiają do kodu.

Zestaw pól zależy od typu. Article dostaje autora, wydawcę i datę publikacji, Product cenę, walutę, dostępność i ocenę, LocalBusiness i Organization adres, telefon i profile w serwisach (sameAs), a Event termin, miejsce, organizatora i cenę biletu. Dzięki temu nie dodasz właściwości, której dany typ nie przewiduje, np. ceny do artykułu. Ta sama wartość z pola wydawcy trafia do publisher (Article), organizer (Event) albo provider (Course), a obraz w typie Organization zapisuje się jako logo.

Przed zbudowaniem kodu generator sprawdza format danych. Nazwa jest obowiązkowa (poza FAQPage) – bez niej pojawia się komunikat „Podaj nazwę (name).”. Adresy strony i obrazu muszą być pełne, z http:// lub https://. Cena ma być liczbą nie mniejszą niż 0 (przecinek dziesiętny jest akceptowany), waluta trzyliterowym kodem ISO 4217, a ocena musi mieścić się w skali 1–5 i mieć podaną liczbę ocen. Przy błędzie kod nie powstaje, a błędne pole zostaje zaznaczone.

Zmiana typu i zaznaczenie opcji FAQ od razu odświeżają podgląd. Po edycji pozostałych pól wynik jest oznaczony jako nieaktualny, dopóki nie klikniesz „Generuj JSON-LD”.

Przykład: od formularza do gotowego kodu krok po kroku

1. Kliknij przykład „Produkt”. Formularz wypełni się danymi słuchawek X200: cena 349,99, waluta PLN, dostępność InStock, ocena 4,6 z 128 ocen.
2. Kliknij „Generuj JSON-LD”. W kodzie pojawi się offers z "price": 349.99, "priceCurrency": "PLN", "availability": "https://schema.org/InStock" i adresem strony oraz aggregateRating z "ratingValue": 4.6, "bestRating": 5 i "ratingCount": 128. Polski przecinek zamienia się na kropkę, której wymaga JSON.
3. Kafelki pokażą 6 właściwości najwyższego poziomu (name, description, url, image, offers, aggregateRating), wymagane przez Google 2 z 2 i zalecane 2 z 2.
4. Usuń cenę i ocenę, a potem wygeneruj kod ponownie. Kod nadal powstanie, ale kontrola zgłosi brak „Oferta lub ocena (offers / aggregateRating)”, a bez tego Google nie pokaże wyniku rozszerzonego dla produktu.
5. Zaznacz „Dodaj też sekcję FAQ”. Pole pytań ma już dwie przykładowe pary w formacie pytanie | odpowiedź, które podmieniasz na własne. Kod zmieni postać na @graph z dwoma węzłami: Product i FAQPage z pytaniami w mainEntity.

Przykład „Wydarzenie” pokazuje obsługę daty: 20 listopada 2026, godz. 18:00 zapisuje się jako 2026-11-20T18:00:00+01:00, czyli z polską strefą czasu zimowego. Dla wydarzenia w lipcu generator doda +02:00.

Typy schema.org i pola, które je zasilają

Każdy typ poza FAQPage ma pola nazwa, opis, adres strony i obraz. Tabela pokazuje, co dochodzi do tego zestawu.

Praktyczne wskazówki użycia

• Zaczynaj od przykładu. Sześć przycisków (Artykuł, Produkt, Firma lokalna, Wydarzenie, Aplikacja, FAQ) ustawia typ i wypełnia cały formularz, nadpisując wpisane wcześniej wartości, więc wczytaj przykład przed wpisaniem własnych danych.
• Przycisk „Wyczyść” nie zostawia pustego formularza, tylko przywraca dane przykładowe: Jan Kowalski, Example Sp. z o.o., ul. Przykładowa 10, telefon +48 22 123 45 67. Przed publikacją sprawdź, czy w kodzie nie zostały wartości z przykładu.
• Dla darmowej aplikacji wpisz cenę 0. Google wymaga offers.price dla SoftwareApplication, a puste pole oznacza brak oferty.
• W polu FAQ wpisuj jedną parę na linię, oddzielając pytanie od odpowiedzi pionową kreską. Linie bez kreski albo z pustą odpowiedzią są pomijane.
• Produkt i firmę lokalną wygeneruj osobno i wklej oba bloki. W jednym kodzie można połączyć tylko wybrany typ z FAQPage.

Czego narzędzie nie uwzględnia

• Prawdziwości danych. Sprawdzany jest format (adres URL, liczba, kod waluty, skala oceny), ale nie to, czy cena i ocena zgadzają się z tym, co widzi użytkownik strony.
• Importu ze strony. Pole url jest tylko wartością w wyniku, a nie adresem do analizy, więc wszystkie dane wpisujesz ręcznie.
• Wszystkich wytycznych Google. Tabela kontrolna sprawdza podstawowe właściwości wymagane i zalecane dla typu. Wariant szczegółowy kursu (Course) wymaga więcej pól, niż ma formularz, a ostateczną ocenę daje Rich Results Test.
• Rozbudowanych struktur. Nie dodasz kilku ofert, pojedynczych recenzji (review), godzin otwarcia ani ścieżki okruszków. Do okruszków służy generator Schema Breadcrumb.