Jak osadzić obraz w HTML lub CSS za pomocą Base64?
Jeden plik zamiast dwóch – kiedy Data URI to dobry wybór i jak go używać, żeby nie spowolnić strony
Autor: Metin Ersoy · Zaktualizowano 10 listopada 2026
Czym jest Data URI
Zwykle strona HTML wskazuje na osobny plik z obrazem, a przeglądarka pobiera go drugim żądaniem. Data URI umieszcza sam obraz w stronie jako tekst. Zaczyna się od krótkiej etykiety określającej typ pliku, po której następuje plik zapisany w Base64:
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA…
Wszędzie tam, gdzie przeglądarka przyjmuje adres obrazu – w atrybucie src znacznika img, w url() w CSS czy w linku do ikony favicon – przyjmie też Data URI.
1. Zamień obraz na Base64
Otwórz Obraz na Base64, wybierz obraz (JPG, PNG, WebP, GIF, SVG, ICO, BMP lub AVIF) i wskaż potrzebny format:
| Chcesz… | Wybierz |
|---|---|
| Wstawić obraz do strony HTML | Znacznik HTML img gotowy do wklejenia |
| Użyć go jako tła w arkuszu stylów | Reguła CSS background-image |
| Wkleić go do JSON, Markdown lub pola formularza | Data URI |
| Wysłać go do API, które wymaga samego kodu | Sam kod Base64, bez prefiksu |
Kliknij Zamień na Base64, a potem Kopiuj tekst. Przy długich wynikach bezpieczniej jest pobrać plik .txt – zaznaczając bardzo długi wiersz ręcznie, łatwo pominąć jego koniec.
2. Wklej go tam, gdzie potrzebujesz
W HTML znacznik img z narzędzia wklejasz prosto do strony. Wpisz w cudzysłowie sensowny tekst alternatywny (alt), żeby czytniki ekranu mogły opisać obraz.
W CSS wklej regułę do wybranego selektora, np. przycisku albo nagłówka. Pamiętaj, żeby nadać elementowi rozmiar – obraz tła sam nie ustala wielkości elementu.
W JSON lub żądaniu do API wklej Data URI (albo sam kod, jeśli tak mówi dokumentacja) jako wartość tekstową. Najpierw sprawdź limit rozmiaru usługi – wiele API odrzuca żądania większe niż kilka megabajtów.
3. Osadzaj tylko małe obrazy
Tekst Base64 jest o około 33% większy niż oryginalny plik i jest pobierany od nowa za każdym razem, gdy zmienia się strona lub arkusz stylów. Praktyczna zasada:
- Poniżej 10 KB – ikony, małe logo, proste kształty: osadzanie to dobry pomysł.
- 10–100 KB – do przyjęcia w dokumentach jednoplikowych, stronach offline i szablonach e-maili.
- Powyżej 100 KB – na stronie internetowej zostaw obraz jako zwykły plik.
Aby zmniejszyć obraz przed konwersją, użyj narzędzia Kompresuj PNG lub Kompresuj JPG albo zmniejsz jego wymiary w pikselach za pomocą narzędzia Zmień rozmiar zdjęcia. Zdjęcie o szerokości 2000 pikseli wyświetlane w szerokości 300 pikseli marnuje większość swojego rozmiaru.
Najczęstsze błędy
- Ucięty tekst. Brak jednego znaku na końcu psuje cały obraz. Kopiuj przyciskiem albo pobierz plik .txt.
- Zły typ w etykiecie. Plik JPG oznaczony jako image/png może wyświetlić się w niektórych przeglądarkach, a w innych nie. Konwerter odczytuje prawdziwy typ z pliku, więc jego etykieta jest zawsze poprawna.
- Podziały wierszy w kodzie. Niektóre edytory zawijają długie wiersze i wstawiają w nie znaki końca linii. W HTML i CSS Data URI musi pozostać w jednym wierszu.
- Ogromne obrazy w CSS. Każda strona korzystająca z arkusza stylów pobiera obraz, nawet jeśli go nigdy nie wyświetla. Duże grafiki zostaw jako pliki.
Kiedy nie używać Base64
Zwykłych plików graficznych używaj do zdjęć, do wszystkiego powyżej ok. 100 KB, do obrazów, które mają pojawiać się w wynikach wyszukiwania, oraz do obrazów używanych na wielu stronach (plik trafia do pamięci podręcznej raz, a osadzony tekst powtarza się na każdej stronie). Base64 to narzędzie do małych, samodzielnych elementów – nie zastępuje plików graficznych.
Chcesz spróbować? To nic nie kosztuje, a plik zostaje na Twoim urządzeniu.
Otwórz narzędzie Obraz na Base64