Alt text bez spamu — jak opisywać obrazy sensownie

przez Łukasz | kwi 1, 2026

Jak pisać alt text, żeby naprawdę pomagał

Alt text jest jednym z tych elementów, które bardzo łatwo zepsuć w dobrą stronę.

Gdy ktoś pierwszy raz słyszy, że obrazy powinny mieć opisy alternatywne, często wpada w jedną z dwóch skrajności: albo nie opisuje ich wcale, albo zaczyna traktować alt jak kolejne pole do upychania słów kluczowych. Obie rzeczy są błędem.

Dobry alt text to po prostu krótki opis tego, co użytkownik powinien zrozumieć z obrazu, jeśli go nie widzi. I właśnie od tego warto zacząć.

Czym właściwie jest alt text

Alt text, czyli tekst alternatywny, to opis obrazu zapisany w atrybucie alt. Jego podstawowa rola nie polega na „pomaganiu Google”, tylko na tym, żeby obraz nie był niemy dla osób korzystających z czytników ekranu, mających problem z załadowaniem grafiki albo odbierających treść strony bez warstwy wizualnej.

Alt nie ma opisywać obrazka „dla zasady”. Ma przekazać jego sens wtedy, gdy sam obraz nie jest dostępny. To bardzo ważna różnica.

Dwa najczęstsze błędy

Pierwszy: opisywanie wszystkiego za bardzo.

Zamiast napisać Kobieta pracująca przy laptopie, wiele osób pisze coś w stylu: Uśmiechnięta młoda kobieta z długimi włosami siedzi przy drewnianym biurku z nowoczesnym srebrnym laptopem, w tle widać roślinę i jasne wnętrze biura. To zwykle nie pomaga.

Dobry alt nie jest literackim opisem kadru. Powinien przekazywać to, co ma znaczenie w kontekście strony. Jeśli obraz ilustruje pracę zdalną, ważniejsze będzie Osoba pracująca przy laptopie niż szczegóły o kolorze stołu i fryzurze.

Drugi: SEO wciśnięte młotkiem.

Alt w stylu tworzenie stron internetowych WordPress Divi projektowanie stron www web designer SEO to nie jest opis obrazu — to lista fraz. Takie alty nie pomagają użytkownikowi, brzmią sztucznie i robią wrażenie mechanicznego upychania słów.

Jeśli obraz naprawdę dotyczy projektowania strony w WordPressie, alt może to zawierać — ale powinien nadal brzmieć jak opis, nie jak worek z frazami. Ekran edytora WordPress podczas budowy strony to ma sens. Lista słów kluczowych — nie.

Najprostsza zasada: opisz funkcję, nie wygląd

Zamiast pytać co dokładnie widać na obrazie?, lepiej zapytać: po co ten obraz tu jest?

Jeśli obraz wnosi treść — alt powinien tę treść przekazać. Jeśli tylko ilustruje ogólny klimat — alt może być krótki i prosty. Jeśli obraz jest czysto dekoracyjny — nie warto robić z niego gadającego elementu na siłę.

To bardzo upraszcza sprawę.

Kiedy alt powinien być konkretny, a kiedy wystarczy prosty

Alt powinien być konkretny, gdy obraz pokazuje ważny ekran, wyjaśnia proces, zawiera informację lub realnie wnosi sens do tekstu. Przy tutorialu Divi różnica wygląda tak:

  • źle: grafika
  • lepiej: Panel dodawania modułów w Divi 5
  • jeszcze lepiej, jeśli szczegóły mają znaczenie: Panel Divi 5 z modułami tekst, obraz i przycisk

Ale nie każdy obraz potrzebuje rozbudowanego opisu. Grafika hero do wpisu, która tylko buduje klimat, może mieć prosty alt: Ilustracja wpisu o dostępności stron — i to jest zupełnie okej. Nie wszystko musi być hiperprecyzyjne.

Jeśli obraz jest czysto dekoracyjny — ozdobny separator, tło, ikona bez znaczenia — nie warto udawać, że niesie treść, jeśli jej nie niesie. Z perspektywy czytnika ekranu każdy niepotrzebny opis to dodatkowy szum.

Jak pisać alt sensownie — prosty model

1. Zadaj sobie pytanie: co użytkownik traci, jeśli nie zobaczy tego obrazu? Jeśli odpowiedź brzmi nic ważnego — alt może być bardzo prosty albo obraz może być dekoracyjny. Jeśli traci ważny kontekst lub krok instrukcji — alt powinien to przekazać.

2. Opisz sens, nie wszystkie szczegóły. Tylko to, co istotne.

3. Pisz naturalnie. Alt ma brzmieć jak krótki opis, nie jak zbiór fraz.

4. Nie zaczynaj od „obraz przedstawia”. To nic nie wnosi. Zamiast Obraz przedstawia panel ustawień formularza — od razu: Panel ustawień formularza kontaktowego.

A co z SEO

Alt text może wspierać SEO, ale tylko wtedy, gdy nadal jest normalnym opisem. Może zawierać słowo ważne dla kontekstu, może doprecyzować temat obrazu — ale nie jako śmietnik na frazy ani sztuczny blok słów kluczowych.

Najpierw dostępność i sens. Dopiero potem ewentualna korzyść SEO. To jest najzdrowsza kolejność.

Podsumowanie

Jeśli nie wiesz, co napisać, wystarczy jeden prosty test: gdyby ktoś nie widział tego obrazu, jakie jedno zdanie naprawdę pomogłoby mu zrozumieć jego rolę?

Dobry alt nie ma być idealny. Ma być użyteczny. Nie opisuje wszystkiego, nie upycha fraz, nie powstaje na siłę — skupia się na funkcji obrazu i przekazuje tylko to, co naprawdę istotne.

Bo alt text nie ma brzmieć jak techniczna formalność. Ma po prostu pomagać.

Agent kończy, ale zadania nie wykonał

Agent kończy, ale zadania nie wykonał

Objawy Agent odpowiada: „Przygotowałem i wysłałem potwierdzenie do klienta." Potwierdzenie nie zostało wysłane. Albo: „Zaktualizowałem wszystkie rekordy" — zaktualizował trzy z dwunastu. Albo: „Nie znalazłem żadnych zamówień" — bo narzędzie zwróciło błąd, którego nikt...

Agent zrobił coś, o co nikt nie prosił

Agent zrobił coś, o co nikt nie prosił

Objawy Operacja, której nikt nie zlecił. Dane wysłane pod adres, którego nie ma w żadnej konfiguracji. Rekord zmieniony poza zakresem zadania. Odpowiedź, z której wynika, że agent dostał instrukcje od kogoś innego niż ty. Cecha wspólna: technicznie wszystko zadziałało...

Agent zrobił to samo dwa razy

Agent zrobił to samo dwa razy

Objawy Ten syndrom różni się od pozostałych jedną rzeczą: objaw widzi klient, nie ty. Trzy identyczne wiadomości w skrzynce. Dwa zamówienia zamiast jednego. Podwójne obciążenie. Duplikaty rekordów, które ktoś zauważa tydzień później. W twoim dzienniku wszystko wygląda...

Agent gubi wątek w długim zadaniu

Agent gubi wątek w długim zadaniu

Objawy Pierwsze kroki idą wzorowo. Po kilkunastu agent zaczyna się rozjeżdżać. Przestaje przestrzegać reguły z promptu systemowego, której trzymał się na początku. Zmienia format odpowiedzi w połowie zadania. Wraca do czegoś, co już ustalił, i ustala to inaczej....

Agent podaje dane, których nie ma

Agent podaje dane, których nie ma

Objawy Numer zamówienia w idealnym formacie, którego nie ma w bazie. Kwota, której w dokumencie nie ma. Nazwa pola API, które nigdy nie istniało. Cytat z regulaminu, brzmiący dokładnie jak reszta regulaminu i w nim nieobecny. Cecha wspólna wszystkich tych przypadków:...

Działał wczoraj, dziś nie działa

Działał wczoraj, dziś nie działa

Objawy Nic się nie wywala. Nie ma wyjątków, nie ma timeoutów, dziennik wygląda tak samo jak zawsze. Po prostu odpowiedzi są gorsze. Postacie, w jakich to się objawia: Jakość. Agent zaczyna pomijać kroki, które wcześniej wykonywał, albo odpowiada ogólniej. Format....

Agent wybiera złe narzędzie

Agent wybiera złe narzędzie

Objawy Agent odpowiada nie na to pytanie. Pobiera listę zamówień, gdy pytano o jedno konkretne. Odpowiada z pamięci, choć miał sprawdzić w bazie. Albo sięga po właściwe narzędzie i wpisuje w argumenty coś, czego nie da się użyć. Sygnał, który odróżnia ten syndrom od...

Agent kręci się w kółko

Agent kręci się w kółko

Objawy Agent wykonuje kolejne obroty pętli, nie zbliżając się do zakończenia zadania. W dzienniku widać jedną z trzech postaci. Powtórzenie. To samo narzędzie, te same argumenty, raz za razem — czasem dziesiątki razy pod rząd. Oscylacja. Agent wywołuje na przemian dwa...