---
title: "JSON-LD"
description: "JSON-LD to zalecany przez Google format osadzania danych strukturalnych schema.org. Zobacz, jak działa i jak pomaga uzyskać rich results w Google."
url: "https://nodea.pl/pl/slownik-pojec/json-ld"
lang: "pl"
updated: "2026-07-13"
---

# JSON-LD

> JSON-LD to format zapisu danych strukturalnych oparty na składni JSON, rekomendowany przez Google do opisywania treści strony słownikiem schema.org w sposób zrozumiały dla wyszukiwarek.

**JSON-LD** (JSON for Linking Data) to format zapisu [danych strukturalnych](https://nodea.pl/pl/slownik-pojec/dane-strukturalne), który wykorzystuje składnię [JSON](https://nodea.pl/pl/slownik-pojec/json) do opisywania zawartości strony w sposób jednoznaczny dla wyszukiwarek. Dzięki niemu roboty nie muszą zgadywać, że dany fragment tekstu to cena, ocena produktu czy data wydarzenia — informacja jest podana wprost, słownikiem [schema.org](https://nodea.pl/pl/slownik-pojec/schema-org). Google jednoznacznie rekomenduje JSON-LD jako preferowany sposób dostarczania tych danych.

## Jak działa JSON-LD?

Znaczniki umieszcza się w osobnym bloku *\<script type="application/ld+json"\>* w sekcji nagłówka lub treści dokumentu. Blok zawiera obiekt JSON opisujący encję — jej typ (*@type*), kontekst (*@context* wskazujący na schema.org) oraz właściwości:

- **@context** — deklaruje słownik, z którego pochodzą właściwości (zwykle *https://schema.org*);
- **@type** — określa rodzaj encji, np. *Product*, *Article*, *FAQPage*, *LocalBusiness*;
- **właściwości** — pary klucz–wartość opisujące encję: nazwę, cenę, autora, ocenę, godziny otwarcia.

Kluczową zaletą jest oddzielenie tych danych od widocznego HTML — kod strony pozostaje czysty, a bloki JSON-LD można generować dynamicznie czy wstrzykiwać przez menedżer tagów, bez ingerencji w szablon.

## Zastosowanie w praktyce

JSON-LD to fundament nowoczesnego technicznego SEO. Poprawnie opisane encje pozwalają uzyskać [rich results](https://nodea.pl/pl/slownik-pojec/rich-results): gwiazdki ocen, ceny i dostępność w sklepach, rozwijane pytania FAQ, breadcrumbs czy karty przepisów. Sklep internetowy oznacza w ten sposób produkty, portal informacyjny — artykuły, a firma lokalna — dane kontaktowe i godziny pracy, co zwiększa widoczność i klikalność w wynikach.

Do wdrożenia i weryfikacji służą narzędzia takie jak Test wyników z elementami rozszerzonymi oraz raport „Ulepszenia” w Google Search Console. Warto pamiętać o żelaznej zasadzie: dane w JSON-LD muszą odzwierciedlać treść faktycznie widoczną na stronie — rozbieżności są traktowane jako próba manipulacji.

### Dlaczego Google zaleca JSON-LD zamiast microdata?

JSON-LD osadza się jako osobny blok skryptu, oddzielony od widocznego kodu HTML, więc nie trzeba przeplatać znaczników wewnątrz treści. Ułatwia to wdrożenie, testowanie i utrzymanie danych strukturalnych, a także wstrzykiwanie ich dynamicznie przez JavaScript lub menedżer tagów.

### Czy JSON-LD gwarantuje wyświetlenie rich results?

Nie. Poprawnie wdrożony JSON-LD sprawia, że strona kwalifikuje się do rozszerzonych wyników, ale to Google ostatecznie decyduje, czy i kiedy je pokazać. Znaczniki muszą też odpowiadać rzeczywistej treści widocznej dla użytkownika, inaczej grozi to ignorowaniem danych lub karą ręczną.

## Powiązane

- [JSON](https://nodea.pl/pl/slownik-pojec/json)
- [Dane strukturalne](https://nodea.pl/pl/slownik-pojec/dane-strukturalne)
- [Schema.org](https://nodea.pl/pl/slownik-pojec/schema-org)
- [Rich Results](https://nodea.pl/pl/slownik-pojec/rich-results)
- [Featured snippets](https://nodea.pl/pl/slownik-pojec/featured-snippets)

---

Wersje językowe: [en](https://nodea.io/en/glossary/json-ld.md)  
Spis treści witryny: [llms.txt](https://nodea.pl/pl/llms.txt)