Jak dodać dane strukturalne Organization do strony firmowej

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 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, 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, 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: „we changed our JSON-LD extraction and are now only applying a single pass of HTML unescaping”. 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 & zamiast ampersandu albo ✔ zamiast znaku ✓. Po zmianie parser zdejmuje tylko jedną warstwę kodowania, więc nazwa firmy z ampersandem trafia do bazy wiedzy jako Kowalski & 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 & oraz &#. 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.