# Jak dodać dane strukturalne Organization do strony firmowej

> Znacznik Organization dodaje się jednym blokiem JSON-LD w sekcji head strony głównej: to formalne oświadczenie dla maszyn, jak firma się nazywa, czym się zajmuje i jak ją znaleźć. W moim pomiarze z sierpnia 2026 miało go tylko 23 z 60 największych spółek giełdowych, a 26 z 60 nie miało żadnych danych strukturalnych — to najtańsza do zamknięcia luka widoczności w AI, bo koszt to kilkadziesiąt linii kodu wklejanych raz. Warunek działania: blok musi stać w kodzie wysyłanym przez serwer, nie być dokładany skryptem.

Autor: Robert Marczyński · Opublikowano: 2026-08-12 · Aktualizacja: 2026-08-27
Kanoniczny URL: https://ekspertodsztucznejinteligencji.pl/odpowiedzi/dane-strukturalne-organization-jak-dodac

Znacznik `Organization` dodaje się jednym blokiem JSON-LD w sekcji `head` strony głównej — poniżej gotowy kod do wypełnienia i sposób weryfikacji. Zanim kod: dlaczego warto. W [moim pomiarze 60 spółek z WIG20 i mWIG40](/blog/widocznosc-ai-wig20-mwig40-pomiar) z sierpnia 2026 to był najczęstszy brak techniczny: 26 stron nie miało żadnych danych strukturalnych, a znacznik firmy miały tylko 23. Jednocześnie to najtańsza rzecz do naprawy z całej listy — kilkadziesiąt linii wklejanych raz.

## Co ten znacznik robi

Model językowy, który buduje odpowiedź o firmie, dostaje z tego bloku wprost: nazwę, czym firma się zajmuje, logo, adres i oficjalne profile. Bez bloku wnioskuje to samo z tekstu strony — zwykle poprawnie, ale bez gwarancji. Pomyłki, które ten znacznik wycina, to mylenie z firmą o podobnej nazwie, przypisanie cudzego adresu i wypadnięcie z zestawień branżowych.

## Gotowy kod

Wklej do sekcji `head` strony głównej i wypełnij własnymi danymi. Pola, których nie znasz albo nie chcesz podawać, **usuń w całości** — puste pole jest gorsze niż brak pola. Druga pozycja `sameAs` to adres wizytówki Google z Map — wklej tam pełny odnośnik do swojej wizytówki.

```
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://twojadomena.pl/#organization",
  "name": "Pełna nazwa firmy",
  "url": "https://twojadomena.pl",
  "logo": "https://twojadomena.pl/logo.png",
  "description": "Jedno zdanie: czym firma się zajmuje i dla kogo.",
  "telephone": "+48 000 000 000",
  "address": {
    "@type": "PostalAddress",
    "streetAddress": "Ulica i numer",
    "postalCode": "00-000",
    "addressLocality": "Miasto",
    "addressCountry": "PL"
  },
  "sameAs": [
    "https://www.linkedin.com/company/twoja-firma",
    "https://www.google.com/maps/adres-twojej-wizytowki"
  ]
}
</script>
```

Trzy zasady, które oszczędzają kłopotów:

**Te same dane wszędzie.** Nazwa, adres i telefon w bloku muszą być znak w znak takie jak na stronie kontaktu i w wizytówce Google. Rozjazd tworzy w oczach maszyn dwie konkurencyjne encje zamiast jednego potwierdzenia.

**Stały `@id`.** Dzięki niemu każda podstrona może wskazywać tę samą encję zamiast tworzyć własną kopię. Powtórzenie węzła z tym samym `@id` na wielu stronach to deklaracja tej samej firmy, nie duplikat.

**W kodzie serwera, nie ze skryptu.** [Boty asystentów AI nie wykonują JavaScriptu](/blog/boty-ai-nie-wykonuja-javascriptu), więc blok dokładany po stronie przeglądarki dla nich nie istnieje. W moim pomiarze żadna spółka, która miała dane strukturalne, nie podawała ich dopiero po wykonaniu skryptów, choć część dokłada skryptem kolejne bloki do tych już obecnych, i to jest właściwy wzorzec.

## Jak zweryfikować

Poziom pierwszy, bez narzędzi — jedna komenda pokazująca, czy blok stoi w dokumencie z serwera:

```
curl -sL https://twojadomena.pl | grep -c "Organization"
```

Wynik większy od zera oznacza, że znacznik jest w kodzie źródłowym. Poziom drugi: wklej adres do [validator.schema.org](https://validator.schema.org/), który odczyta blok tak, jak zrobi to maszyna, i wskaże błędy składni oraz pól.

## Pułapka: podwójnie zakodowane znaki

Blok może być poprawny merytorycznie i mimo to zostać odczytany błędnie. Google zmienił sposób odczytu danych strukturalnych, a Search Engine Roundtable opisał to 21 sierpnia 2026, cytując wyjaśnienie Google: „<span lang="en">we changed our JSON-LD extraction and are now only applying a single pass of HTML unescaping</span>”. Wcześniej parser rozwijał podwójnie zakodowane encje HTML, czyli po cichu naprawiał kod, w którym generator szablonu zamienił znaki dwa razy. Teraz tego nie robi.

W praktyce dotyczy to stron, na których w JSON-LD stoją zapisy w rodzaju `&amp;amp;` zamiast ampersandu albo `&amp;#10004;` zamiast znaku ✓. Po zmianie parser zdejmuje tylko jedną warstwę kodowania, więc nazwa firmy z ampersandem trafia do bazy wiedzy jako `Kowalski &amp; Wspólnicy`, a nie jako `Kowalski & Wspólnicy`. Poprawny zapis w JSON opisuje RFC 8259: albo znak wprost, albo sekwencja unikowa w rodzaju `\u0026`, nigdy encja HTML zakodowana po raz drugi.

W kodzie widać to od razu: w bloku `application/ld+json` szukaj ciągów `&amp;amp;` oraz `&amp;#`. Jeśli są, generator szablonu koduje encje dwa razy i trzeba to wyłączyć dla tego bloku. Walidator Schema.org pokazuje wartość po odkodowaniu, więc różnica rzuca się w oczy.

## Co dalej

`Organization` jest fundamentem. W drugiej kolejności mają sens: węzeł osoby dla eksperta firmy, typ `Service` albo `Product` dla oferty i `FAQPage` dla stron z pytaniami. Ale kolejność wynika z danych: najpierw powiedz maszynom, **kim jesteś** — tego brakuje najczęściej i to kosztuje najmniej. Pozostałe warunki widoczności zebrałem w [diagnozie, dlaczego firmy nie ma w ChatGPT](/odpowiedzi/dlaczego-firmy-nie-ma-w-chatgpt).

## Najczęstsze pytania

**Czym są dane strukturalne i po co firmie znacznik Organization?**

Dane strukturalne to blok w kodzie strony zapisany w formacie JSON-LD, który opisuje treść w sposób jednoznaczny dla maszyn. Znacznik typu Organization to formalne oświadczenie: to jest firma, nazywa się tak, to jej logo, adres i profile. Bez niego model językowy musi zgadywać tożsamość firmy z tekstu i wtedy zdarzają się pomyłki: mylenie ze spółką o podobnej nazwie albo pominięcie w zestawieniu dostawców. Według mojego pomiaru z sierpnia 2026 znacznik miało 23 z 60 największych spółek GPW.

**Gdzie umieścić blok JSON-LD i czy musi być na każdej podstronie?**

Minimum to strona główna, bo od niej boty zaczynają budowanie obrazu firmy; dobrą praktyką jest powtarzanie tego samego węzła na każdej stronie przez stały identyfikator @id, żeby wszystkie strony wskazywały jedną encję. Blok wstawia się w sekcji head jako script typu application/ld+json. Warunek jest jeden: blok musi stać w dokumencie wysyłanym przez serwer, bo boty AI nie wykonują JavaScriptu — blok dokładany skryptem dla większości z nich nie istnieje.

**Jak sprawdzić, czy znacznik Organization działa?**

Dwa poziomy. Szybki: otwórz źródło strony (Ctrl+U) i sprawdź, czy blok application/ld+json z typem Organization jest w kodzie, a nie tylko na ekranie. Formalny: wklej adres strony do walidatora Schema.org pod adresem validator.schema.org, który pokaże odczytane pola i błędy składni. W terminalu wystarczy pobrać stronę i wyszukać w niej frazę Organization — komenda jest w treści tej odpowiedzi.

**Jakich błędów unikać przy danych strukturalnych firmy?**

Cztery najczęstsze. Podwójne kodowanie znaków: Google ogłosił 21 sierpnia 2026, że odkodowuje encje HTML w JSON-LD tylko raz, więc podwójnie zakodowany ampersand nie zamienia się już w znak, tylko zostaje w danych jako encja. Puste pola: wartość, której nie znasz, pomiń zamiast wpisywać pusty tekst, bo puste pole wygląda na daną, którą nie jest. Rozjazd z treścią: nazwa, adres i telefon w JSON-LD muszą być znak w znak takie same jak na stronie i w wizytówce Google, inaczej powstają dwie konkurencyjne wersje encji. Dokładanie skryptem: blok wstrzyknięty JavaScriptem czyta Google, ale nie boty asystentów, więc trafia tylko do części odbiorców.


## Źródła

- Search Engine Roundtable — Google zmienił ekstrakcję JSON-LD na jeden przebieg odkodowania encji (21.08.2026): https://www.seroundtable.com/json-ld-extraction-googlebot-41921.html
- RFC 8259 — format JSON: dopuszczalne sposoby zapisu znaków specjalnych (sekcja 7): https://www.rfc-editor.org/rfc/rfc8259.html
- Badanie własne — widoczność stron WIG20 i mWIG40 dla asystentów AI (pomiar 10–11.08.2026): Organization 23/60, brak JSON-LD 26/60: https://ekspertodsztucznejinteligencji.pl/badania/widocznosc-wig-2026-08
- Schema.org — definicja typu Organization i lista pól: https://schema.org/Organization
- Walidator danych strukturalnych Schema.org: https://validator.schema.org/