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ć.
![]()
Jedna linia wystarczy, dopóki plik i serwer nie robią niespodzianek
- Minimum: dodaj element
w sekcji nagłówkowej dokumentu. - Ścieżka: zapis
/favicon.pngprowadzi 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-Typei 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
linki 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.
