Favicon w HTML bez błędów - kod, formaty i diagnostyka

Jeremi Andrzejewski • 20 listopada 2026
Lupa powiększa ikonę łapy, symbolizującą favicon w kodzie HTML strony internetowej.

Spis treści

Otwierasz stronę w kilku kartach i zamiast rozpoznawalnego znaku widzisz pusty globus albo ikonę domyślną przeglądarki. W większości przypadków wystarczy dodać jeden element , ale rezultat zależy od ścieżki pliku, jego formatu oraz miejsca, w którym ikona ma się pojawić.

Szukamy idealnego favicon html. Lupa powiększa gwiazdkę na stronie, symbolizującą ulubione elementy.

Jedna linia wystarczy, dopóki plik i serwer nie robią niespodzianek

  • Minimum: dodaj element w sekcji nagłówkowej dokumentu.
  • Ścieżka: zapis /favicon.png prowadzi do katalogu głównego domeny, a ścieżka bez ukośnika zależy od adresu bieżącej strony.
  • Format: PNG sprawdzi się w większości projektów, ICO pomaga w szerokiej zgodności, a SVG zachowuje ostrość przy skalowaniu.
  • Google: ikona dla wyników wyszukiwania musi być kwadratowa, dostępna dla robotów i przypisana do strony głównej hosta.
  • Diagnostyka: gdy favicon nie działa, sprawdź status HTTP, nagłówek Content-Type i faktyczny adres pliku.

Jedna linia kodu dodaje ikonę do strony

Najprostszy zapis wygląda tak:

Element umieść w sekcji nagłówkowej każdego dokumentu, który ma korzystać z ikony. Atrybut href wskazuje plik, rel="icon" mówi przeglądarce, że zasób reprezentuje stronę, a type podpowiada format obrazu.

Najczęstszy błąd kryje się w ścieżce. Przy zapisie href="/favicon.png" przeglądarka szuka pliku pod adresem w rodzaju example.pl/favicon.png. Przy zapisie href="favicon.png" dla strony znajdującej się pod example.pl/kurs/html/ szuka pliku w katalogu /kurs/html/.

Jeżeli favicon leży w katalogu assets/icons, użyj pełnej ścieżki publicznej:

Plik musi być dostępny przez serwer. Obraz zapisany obok projektu na dysku nie wystarczy, jeśli wdrożona strona publikuje zasoby z innego katalogu albo zmienia ścieżki podczas budowania aplikacji.

Cztery atrybuty rozstrzygają, którą ikonę wybierze przeglądarka

Na pierwszy rzut oka wszystkie zapisy favicon wyglądają podobnie. Różnica między nimi zaczyna się dopiero wtedy, gdy dodasz kilka formatów albo umieścisz plik poza katalogiem głównym.

Atrybut Co określa Typowy błąd
rel Relację zasobu z dokumentem, na przykład ikonę strony. Użycie samego shortcut zamiast icon.
href Publiczny adres pliku graficznego. Wskazanie ścieżki z dysku komputera albo błędnego katalogu.
type Deklarowany typ MIME, na przykład image/png. Podanie typu PNG przy pliku SVG.
sizes Dostępne rozmiary obrazu, na przykład 32x32 albo any. Wpisanie rozmiaru, którego plik faktycznie nie zawiera.

Współczesny zapis powinien używać rel="icon". Według HTML Living Standard forma shortcut icon ma historyczne uzasadnienie, ale nie jest potrzebna w nowym kodzie. Popularny mit mówi, że słowo shortcut zwiększa zgodność z przeglądarkami. W praktyce lepiej zostawić samo icon, a zgodność budować przez prawidłowy plik i odpowiedź serwera.

Jeśli deklarujesz kilka ikon, przeglądarka bierze pod uwagę między innymi format, rozmiar i warunek media. Dokumentacja MDN dla atrybutu rel opisuje też sytuację, w której kilka plików pasuje równie dobrze: wtedy może zostać wybrany ostatni z nich.



Nie wpisuj sizes="any" przy zwykłym PNG. Ten zapis opisuje ikonę skalowalną, typowo wektorową, taką jak SVG.

Format dobierz do miejsca, w którym ikona ma działać

PNG, ICO i SVG nie są trzema nazwami tego samego rozwiązania. Każdy format odpowiada na trochę inną potrzebę.

Format Kiedy go wybrać Na co uważać
PNG Gdy potrzebujesz prostego obrazu z przezroczystością i przewidywalnego działania. Przy bardzo małym rozmiarze szczegóły mogą zniknąć.
ICO Gdy chcesz zachować szeroką zgodność albo umieścić kilka rozmiarów w jednym pliku. Nie każdy generator tworzy poprawny plik wielorozmiarowy.
SVG Gdy znak jest prosty, wektorowy i ma wyglądać ostro przy różnych skalach. Serwer musi zwracać poprawny typ image/svg+xml.

Gdybym wybierał wariant dla małego projektu HTML, postawiłbym na PNG w rozmiarze 48×48 lub większym. Dla strony z prostym znakiem graficznym dodałbym także SVG, a przy wymaganiu starszej zgodności zostawiłbym ICO jako bezpieczny wariant dodatkowy.

Przykład z PNG:

Przykład z SVG:

Jeżeli użytkownik zapisuje stronę na ekranie telefonu, zwykła favicon może nie wystarczyć. W takim przypadku dochodzą osobne zasoby, takie jak apple-touch-icon albo ikony z manifestu aplikacji webowej. Nie mieszaj jednak tych mechanizmów z podstawowym oznaczeniem karty przeglądarki.

Google ocenia favicon inaczej niż karta przeglądarki

Ikona może działać perfekcyjnie w karcie, a mimo tego nie pojawić się przy wyniku wyszukiwania. Powód jest prosty: przeglądarka i Google sprawdzają inne warunki.

Zgodnie z aktualnymi wytycznymi Google Search Central favicon przeznaczona do wyników wyszukiwania powinna być kwadratowa, mieć co najmniej 8×8 pikseli, a dla lepszego wyglądu Google zaleca obraz większy niż 48×48 pikseli. Adres pliku powinien pozostać stabilny, a strona główna i sam obraz muszą być dostępne dla robotów indeksujących.

Google przypisuje jedną favicon do jednego hosta. Oznacza to, że example.pl/blog i example.pl/kurs korzystają z tej samej ikony, nawet jeśli są osobnymi katalogami. Osobny znak może działać dla docs.example.pl, ponieważ subdomena jest innym hostem.

Praktyczna reguła wygląda tak:

  • jeśli potrzebujesz ikony w karcie, wystarczy poprawny element link i dostępny plik;
  • jeśli zależy Ci również na wynikach Google, wybierz kwadratowy obraz większy niż 48×48 pikseli, umieść link na stronie głównej i nie blokuj pliku w robots.txt;
  • jeśli chcesz różnych ikon dla katalogów tej samej domeny, sam HTML tego nie zapewni w wynikach wyszukiwania.

Nawet po spełnieniu warunków wyświetlenie ikony w Google nie jest gwarantowane. Aktualizacja zależy od ponownego odczytania strony i przetworzenia pliku, więc zmiana w kodzie nie musi być widoczna od razu.

Gdy obraz się nie pojawia, zacznij od odpowiedzi serwera

Przeglądanie samego kodu HTML często prowadzi na manowce. Element może wyglądać poprawnie, a serwer może zwracać pod jego adresem stronę błędu, niewłaściwy typ MIME albo przekierowanie do innego zasobu.

Sytuacja Prawdopodobna przyczyna Co zrobić
Ikona nie pojawia się w żadnej karcie Błędny href albo brak elementu w dostarczonym HTML. Otwórz źródło strony i sprawdź, czy adres pliku prowadzi do właściwego katalogu.
Plik zwraca 404 Ścieżka względna została odniesiona do innego katalogu niż zakładano. Użyj ścieżki od katalogu głównego, na przykład /assets/favicon.png.
Plik zwraca 200, ale przeglądarka go ignoruje Serwer wysyła nieprawidłowy Content-Type albo treść nie pasuje do rozszerzenia. W narzędziach deweloperskich sprawdź nagłówki odpowiedzi i typ faktycznie zwróconego obrazu.
Ikona działa lokalnie, ale nie po wdrożeniu Hosting, CDN albo proces budowania zmienił publiczny adres pliku. Testuj adres dostępny po HTTPS, a nie ścieżkę pliku z komputera.
Ikona działa w karcie, lecz nie w Google Google nie odczytał jeszcze zmiany, plik jest blokowany albo strona należy do hosta z inną ikoną. Sprawdź dostępność strony głównej, pliku i reguł indeksowania.

Nagłówek Content-Type opisuje format danych zwracanych przez serwer. Jak wyjaśnia MDN w dokumentacji Content-Type, rozszerzenie pliku nie zastępuje poprawnego typu odpowiedzi. Dla PNG powinien pojawić się image/png, a dla SVG image/svg+xml.

Podobnie jak przy tabeli HTML, która ma działać w różnych warunkach, tutaj również testuj efekt w środowisku docelowym. Otwórz publiczny adres ikony w nowej karcie, przeładuj stronę z otwartym panelem Network i sprawdź, czy odpowiedź ma właściwy status oraz typ pliku.

Po wdrożeniu sprawdź publiczny adres, nie sam kod

Najpewniejszy test zajmuje chwilę: odczytaj element link z dostarczonego HTML, otwórz adres zapisany w href i sprawdź odpowiedź serwera. Jeśli widzisz obraz, status 200 i właściwy typ MIME, problem zwykle przenosi się do cache przeglądarki, wyboru między kilkoma ikonami albo opóźnienia po stronie wyszukiwarki.

W prostym projekcie wystarczy jeden dobrze przygotowany PNG i zapis rel="icon". Gdy strona ma działać jako rozbudowany interfejs, dodaj osobne warianty dopiero wtedy, gdy konkretny kontekst, taki jak ekran telefonu, PWA albo wyniki wyszukiwania, rzeczywiście ich wymaga.

FAQ - Najczęstsze pytania

Element <link rel="icon" href="/favicon.png" type="image/png"> umieść w sekcji <head> dokumentu. Ścieżka zaczynająca się od ukośnika, na przykład /favicon.png, prowadzi do katalogu głównego domeny, natomiast favicon.png jest liczona względem adresu bieżącej strony.

PNG sprawdzi się w większości projektów, ICO pomaga zachować szeroką zgodność i może zawierać kilka rozmiarów, a SVG zachowuje ostrość przy skalowaniu. Dla SVG użyj type="image/svg+xml" i sizes="any", natomiast przy PNG zadeklaruj rzeczywisty rozmiar, na przykład 32x32 lub 48x48.

Google wymaga, aby favicon była kwadratowa, dostępna dla robotów i przypisana do strony głównej hosta. Minimalny rozmiar to 8×8 pikseli, ale Google zaleca obraz większy niż 48×48 pikseli. Ikona może być wspólna dla katalogów tej samej domeny, a osobna dla subdomeny.

Otwórz publiczny adres zapisany w atrybucie href i sprawdź, czy plik zwraca status HTTP 200 oraz właściwy nagłówek Content-Type. Dla PNG powinno to być image/png, a dla SVG image/svg+xml. Upewnij się także, że hosting, CDN lub proces budowania nie zmieniły adresu pliku.

Oceń artykuł

Ocena: 4.00 Liczba głosów: 1

Tagi

favicon
html
png
svg
mime
Autor Jeremi Andrzejewski
Jeremi Andrzejewski
Nazywam się Jeremi Andrzejewski i od 13 lat zajmuję się programowaniem, w szczególności w języku Python oraz nowoczesnymi technologiami. Moje zainteresowanie tymi tematami zaczęło się od pierwszych projektów, które realizowałem w szkole, a z czasem przerodziło się w pasję do rozwiązywania problemów i tworzenia innowacyjnych rozwiązań. Lubię dzielić się swoją wiedzą, szczególnie w zakresie analizy danych, automatyzacji procesów oraz tworzenia aplikacji webowych. W swojej pracy koncentruję się na dostarczaniu użytecznych, klarownych i aktualnych informacji. Staram się zawsze sprawdzać źródła, porównywać dostępne informacje i upraszczać skomplikowane zagadnienia, aby były zrozumiałe dla każdego. Wierzę, że odpowiednie zorganizowanie wiedzy oraz śledzenie najnowszych trendów w branży są kluczowe dla efektywnego nauczania i rozwoju. Cieszę się, że mogę dzielić się swoimi doświadczeniami na akademiapython.pl, gdzie mam nadzieję inspirować innych do odkrywania fascynującego świata programowania.

Udostępnij artykuł

Napisz komentarz