PUWU Insights Library · A
Atrybut alt (tekst alternatywny) – co to jest i jak opisywać obrazy pod SEO oraz dostępność
- w skrócie
- Atrybut alt (tekst alternatywny) to atrybut w kodzie HTML znacznika obrazu (`<img alt="…">`), który opisuje słowami, co przedstawia grafika i jaką pełni funkcję na stronie. Korzystają z niego czytniki ekranu osób niewidomych, wyszukiwarki internetowe oraz przeglądarki, gdy obrazek się nie załaduje.
W tym haśle wyjaśniamy, jak działa atrybut alt w kodzie HTML, dlaczego jest jednocześnie elementem SEO i wymogiem dostępności cyfrowej (WCAG), kiedy należy go uzupełnić, a kiedy celowo zostawić pustym, oraz jak pisać opisy na konkretnych przykładach.

Jak wygląda atrybut alt w kodzie i w WordPressie
W kodzie HTML tekst alternatywny zapisuje się wewnątrz znacznika <img>:
<img src="/uploads/zespol-kancelarii-lodz.webp" alt="Adwokaci kancelarii przy stole konferencyjnym podczas narady.">
W systemach CMS takich jak WordPress nie musisz edytować kodu ręcznie. Po wgraniu pliku do Biblioteki mediów lub dodaniu bloku „Obraz” w edytorze widzisz w panelu bocznym pole Tekst alternatywny (alt). To, co w nim wpiszesz, szablon automatycznie wstawia do atrybutu alt w kodzie strony.
Po co stosuje się tekst alternatywny
Atrybut alt rozwiązuje trzy problemy naraz:
- Dostępność cyfrowa (WCAG 1.1.1) – osoby niewidome i słabowidzące korzystają z czytników ekranu (np. NVDA, VoiceOver), które czytają na głos zawartość strony. Gdy czytnik trafia na grafikę, odczytuje jej atrybut
alt. Od 28 czerwca 2025 r., wraz z wejściem w życie przepisów wdrażających Europejski Akt o Dostępności (Polski Akt o Dostępności), dostępność stron i usług cyfrowych przestała być wyłącznie kwestią administracji publicznej i objęła także wybrane branże komercyjne (m.in. e-commerce, bankowość czy usługi telekomunikacyjne). - Zrozumienie obrazu przez wyszukiwarki – wytyczne Google Search Central wskazują wprost, że tekst alternatywny (obok nazwy pliku i tekstu otaczającego grafikę) pomaga zrozumieć temat obrazu i powiązać go z treścią podstrony. To podstawowy element on-page SEO, który decyduje o widoczności w Google Grafika i w wynikach uniwersalnych.
- Sytuacje awaryjne – gdy użytkownik ma słabe połączenie mobilne, blokuje obrazy w kliencie pocztowym albo plik graficzny został usunięty z serwera, przeglądarka wyświetla w ramce właśnie treść atrybutu
alt.
Kiedy obraz jest linkiem – atrybut alt jako anchor text
Szczególną rolę atrybut alt pełni wtedy, gdy obrazek jest jednocześnie odnośnikiem (znacznik <img> znajduje się wewnątrz <a href="…">), np. w logotypie w nagłówku, banerze czy kafelku prowadzącym do usługi.
Zgodnie z dokumentacją Google, jeśli w takim linku nie ma zwykłego tekstu, wyszukiwarka traktuje zawartość atrybutu alt dokładnie tak samo jak tekst kotwicy (anchor text) zwykłego linku tekstowego. Pusty atrybut alt="" w obrazku będącym linkiem to podwójny błąd: Googlebot traci informację, dokąd prowadzi odnośnik, a użytkownik czytnika ekranu słyszy jedynie „link” i surowy adres URL pliku.
Cztery typy obrazów – co wpisać w atrybucie alt
Najczęstszy mit mówi, że „każdy obrazek na stronie musi mieć wpisany opis ze słowem kluczowym”. Standard W3C WAI (An alt Decision Tree) dzieli obrazy według funkcji, jaką pełnią na konkretnej podstronie:
| Typ obrazu | Przykład na stronie firmy lub kancelarii | Co wpisać w alt |
|---|---|---|
| Informacyjny (wnosi treść lub kontekst) | Zdjęcie zespołu, zdjęcie siedziby, zrzut ekranu z Google Search Console | Zwięzły opis tego, co widać i co jest istotne w kontekście akapitu. |
| Funkcjonalny (jest linkiem lub przyciskiem) | Logo w nagłówku prowadzące na stronę główną, ikona lupy w przycisku wyszukiwania | Cel linku lub działanie przycisku (np. Strona główna PUWU, Szukaj w serwisie), a nie wygląd ikony. |
| Dekoracyjny (ozdoba bez wartości informacyjnej) | Abstrakcyjny gradient w tle sekcji, ozdobny separator, powtórzona ikona obok podpisanego nagłówka | Pusty atrybut alt="" (bez spacji w środku) – czytnik ekranu pominie element. |
| Złożony (wykres, tabela na grafice, schemat) | Wykres spadku ruchu po migracji, schemat postępowania sądowego | Krótkie podsumowanie wniosku z wykresu w alt, a pełne dane w tekście obok. |
Puste alt="" a całkowity brak atrybutu alt
Warto odróżnić dwie sytuacje w kodzie HTML, które w narzędziach audytowych wyglądają podobnie, ale działają zupełnie inaczej:
<img src="ozdoba.svg" alt="">(pusty atrybut alt) – prawidłowe oznaczenie grafiki dekoracyjnej. Mówisz przeglądarce i czytnikowi ekranu: „ten obrazek to tylko oprawa wizualna, przejdź od razu do tekstu”.<img src="ozdoba.svg">(brak atrybutu alt) – błąd techniczny. Czytnik ekranu nie wie, czy autor zapomniał o opisie ważnego zdjęcia, czy to dekoracja, więc często odczytuje użytkownikowi nazwę pliku, np.IMG_20261110_final_v2.jpg.
Jak pisać dobre opisy – dobre i złe przykłady
Dobry tekst alternatywny piszesz dla człowieka, który nie widzi ekranu – jakbyś przez telefon krótko powiedział mu, jakie zdjęcie ilustruje dany fragment tekstu. Wpisuje się to w nowoczesne pozycjonowanie (SEO), w którym liczy się naturalny kontekst, a nie mechaniczne powtarwanie fraz.
Porównajmy cztery sytuacje na przykładzie zdjęcia adwokatki występującej przed sądem w artykule o wizerunku prawnika w internecie:
- Brak kontekstu (za ogólnie):
alt="prawnik"– nie mówi nic poza tym, że na zdjęciu jest przedstawiciel zawodu. - Keyword stuffing (upchanie słów kluczowych):
alt="adwokat Łódź kancelaria adwokacka Łódź rozwody porady prawne"– narusza wytyczne Google dotyczące spamu i utrudnia odbiór osobom korzystającym z czytników ekranu. - Zbędne wypełniacze:
alt="Zdjęcie przedstawiające panią adwokat stojącą na sali rozpraw"– pierwsze dwa słowa są nadmiarowe. - Prawidłowy opis:
alt="Adwokatka w todze zabierająca głos na sali rozpraw."– konkretnie, naturalnie i w jednym zdaniu.
Na koniec pamiętaj o jednej pułapce technicznej: Googlebot nie indeksuje obrazów wstawionych jako tło w arkuszach stylów (background-image w CSS). Jeśli grafika niesie ważną informację i zależy Ci na jej indeksacji, osadź ją w kodzie za pomocą standardowego znacznika <img> (lub <picture>) z uzupełnionym atrybutem alt.
Źródła
- Google Search Central – „Google image SEO best practices”: jak Google wykorzystuje atrybut alt i otaczający tekst do rozumienia grafik oraz dlaczego należy unikać upychania słów kluczowych. developers.google.com
- Google Search Central – „Link best practices for Google”: rola atrybutu alt jako tekstu kotwicy (anchor text), gdy obraz pełni funkcję linku. developers.google.com
- W3C Web Accessibility Initiative (WAI) – „Images Tutorial & An alt Decision Tree”: podział obrazów na informacyjne, funkcjonalne, dekoracyjne i złożone oraz zasady stosowania pustego atrybutu
alt="". w3.org - W3C – „Web Content Accessibility Guidelines (WCAG) 2.1 – Kryterium sukcesu 1.1.1 Treść nietekstowa”: wymóg zapewnienia alternatywy tekstowej dla treści nietekstowych. w3.org
Powiązane pojęcia
Najczęstsze pytania.
Jaka jest zalecana długość atrybutu alt?
Standardy WCAG i wytyczne Google nie narzucają sztywnego limitu znaków, ale w praktyce najlepiej sprawdza się zwięzłe zdanie lub równoważnik zdania (zwykle od kilku do kilkunastu słów, około 80–125 znaków). Jeśli wykres wymaga dłuższego omówienia, umieść szczegółowe dane w treści artykułu pod grafiką.
Czy pisać w atrybucie alt słowa „zdjęcie” albo „obrazek”?
Nie. Czytnik ekranu sam informuje użytkownika, że natrafił na element graficzny, więc wpisanie „Zdjęcie przedstawiające…” powoduje niepotrzebne powtórzenie. Wyjątkiem jest sytuacja, w której sam format ma znaczenie dla odbioru, np. „Skan uchwały Sądu Najwyższego z 2024 roku”.
Czym różni się atrybut alt od atrybutu title przy obrazku?
Atrybut alt zastępuje obraz, gdy nie można go zobaczyć, i jest odczytywany przez czytniki ekranu oraz brany pod uwagę przez Google jako podstawowy opis grafiki. Atrybut title wyświetla jedynie dymek po najechaniu kursorem myszy – nie działa na ekranach dotykowych i nie zastępuje tekstu alternatywnego.
Czy kropka na końcu atrybutu alt ma znaczenie?
Dla wyszukiwarek nie ma znaczenia, ale pomaga użytkownikom czytników ekranu. Kropka na końcu opisu sprawia, że syntezator mowy robi krótką pauzę przed przejściem do kolejnego elementu strony.