Zgodność HTML email 2026 — Outlook, Gmail i tryb ciemny
Co musi wiedzieć email developer o zgodności HTML email: kaprysy renderowania w Outlooku i VML, obsługa CSS w Gmailu, tryb ciemny i testy przed wysyłką.
Mail, który w Twojej przeglądarce wygląda idealnie, może dotrzeć do skrzynki subskrybenta rozsypany, bo każdy klient pocztowy renderuje HTML po swojemu. Ten przewodnik omawia klienty, które sprawiają najwięcej kłopotów, wyjaśnia, dlaczego zachowują się tak, a nie inaczej, i pokazuje praktyczne wzorce, dzięki którym kampania pozostaje czytelna wszędzie. Jest napisany dla marketerów, projektantów i developerów, którzy chcą mniej niespodzianek po kliknięciu „Wyślij”.
Dlaczego zgodność HTML email wciąż jest trudna
Przeglądarki internetowe już lata temu dogadały się co do wspólnych standardów. Klienty pocztowe nie. Mail renderuje silnik, którego używa klient odbiorcy, a te silniki różnią się ogromnie:
- Outlook dla Windows (klasyczne wersje desktopowe) renderuje HTML silnikiem układu Microsoft Word, a nie silnikiem przeglądarki.
- Gmail przepuszcza Twój kod przez własny sanitizer, przepisuje nazwy klas i usuwa CSS, na który nie pozwala.
- Apple Mail i iOS Mail korzystają z WebKit i obsługują większość nowoczesnego CSS.
- Poczta webowa i aplikacje mobilne dokładają do Twojego kodu własne wrappery, style i zachowanie w trybie ciemnym.
Nie masz wpływu na to, z jakiego klienta korzysta subskrybent, więc zgodność z klientami pocztowymi sprowadza się do jednej zasady: pisz kod, który wyrenderuje najsłabszy klient, a potem dokładaj ulepszenia dla klientów, które je obsługują. Nazywa się to często progressive enhancement, a patrząc od drugiej strony — graceful degradation.
Podstawa, która działa prawie wszędzie
Zanim przyjrzymy się poszczególnym klientom, warto znać fundament, na którym polegają doświadczeni email developerzy:
| Technika | Dlaczego to ważne |
|---|---|
| Układ tabelaryczny | Tabele to jedyny model układu, który rozumie każdy klient, łącznie z silnikiem Worda w Outlooku. |
| Style inline | Niektóre klienty i ścieżki przekazywania usuwają bloki <style>, więc kluczowe style powinny siedzieć na elemencie. |
| Stała szerokość treści w okolicach 600px | Mieści się w panelach podglądu i klientach desktopowych, a na mobile się zmniejsza. |
| Fonty zastępcze web-safe | Własne fonty wczytują się tylko w części klientów; reszta potrzebuje rozsądnego fontu zastępczego. |
| Jawne wymiary obrazów | Zapobiegają skokom układu i dziwnemu skalowaniu, zwłaszcza w Outlooku. |
Atrybuty bgcolor obok CSS |
Dają starszym klientom kolor tła nawet wtedy, gdy tła CSS są ignorowane. |
Minimalny, solidny szkielet wygląda tak:
<table cellpadding="0" cellspacing="0" border="0" width="100%">
<tr>
<td align="center" bgcolor="#F4F4F4">
<table cellpadding="0" cellspacing="0" border="0" width="600"
style="width: 600px; max-width: 600px;">
<tr>
<td style="padding: 24px; font-family: Arial, Helvetica, sans-serif;
font-size: 16px; line-height: 24px; color: #222222;">
Hello from a table-based layout.
</td>
</tr>
</table>
</td>
</tr>
</table>
Wszystko inne w tym przewodniku buduje na tej idei.
HTML email w Outlooku: silnik Worda i jego kaprysy
Większość problemów ze zgodnością prowadzi do Outlooka dla Windows. Klasyczne wersje desktopowe renderują HTML za pomocą Worda, co oznacza, że spora część nowoczesnego CSS po prostu tam nie istnieje. Nowsze aplikacje Outlook, w tym Outlook w przeglądarce i nowy Outlook dla Windows, zachowują się dużo bardziej jak przeglądarka, ale wiele organizacji wciąż używa klasycznego klienta desktopowego, więc warto projektować z myślą o nim.
Co klasyczny Outlook ignoruje lub psuje
max-widthnie jest obsługiwane, więc płynne kontenery mogą rozciągać się na całe okno.marginjest zawodny. Odstępy powinny pochodzić zpaddingna komórkach tabeli albo z rzędów-spacerów.- Obrazy w tle w CSS nie są wyświetlane. Klasyczny Outlook potrzebuje VML (Vector Markup Language) albo atrybutu HTML
backgroundoraz jednolitego koloru zastępczego. border-radiusjest ignorowane, więc zaokrąglone przyciski i karty renderują się z kwadratowymi rogami.- Gradienty nie są renderowane. Bez koloru zastępczego obszar może się wyświetlić jako pusty.
colspanirowspanmogą dawać nieprzewidywalne układy. Zagnieżdżone tabele są bezpieczniejsze.- Stałe wysokości połączone z paddingiem często sumują się w nieoczekiwany sposób, przez co bloki są wyższe niż zamierzano.
- Fonty webowe nie są wczytywane, a podanie własnego fontu w inline'owym
font-familymoże sprawić, że Outlook zamiast zamierzonego fontu zastępczego użyje Times New Roman.
Komentarze warunkowe: rozmowa bezpośrednio z Outlookiem
Outlook rozumie specjalne komentarze warunkowe, które inne klienty traktują jak zwykłe komentarze HTML. Pozwalają one dać Outlookowi osobny kod, nie wpływając na nikogo innego. Najczęstsze zastosowanie to wrapper o stałej szerokości, bo Outlook ignoruje max-width:
<!--[if (gte mso 9)|(IE)]>
<table cellpadding="0" cellspacing="0" border="0" width="600"><tr><td>
<![endif]-->
<table cellpadding="0" cellspacing="0" border="0" width="100%"
style="max-width: 600px;">
<!-- treść -->
</table>
<!--[if (gte mso 9)|(IE)]>
</td></tr></table>
<![endif]-->
Nowoczesne klienty używają tabeli z max-width i zmniejszają ją na mobile. Outlook widzi tabelę o stałej szerokości 600px i zachowuje układ.
Często dodaje się też w <head> blok ustawień Office, który pomaga Outlookowi obsłużyć obrazy PNG i zapobiega części problemów ze skalowaniem na ekranach Windows o wysokim DPI:
<!--[if gte mso 9]>
<xml>
<o:OfficeDocumentSettings>
<o:AllowPNG/>
<o:PixelsPerInch>96</o:PixelsPerInch>
</o:OfficeDocumentSettings>
</xml>
<![endif]-->
Obrazy w tle i VML
Jeśli baner hero ma tekst na zdjęciu w tle, to zwykle właśnie w klasycznym Outlooku wszystko się sypie. Możesz celować w trzy poziomy obsługi:
- Jednolity kolor zastępczy. Zawsze ustawiaj
bgcolorna komórce, żeby tekst był czytelny, nawet jeśli obraz się nie pojawi. - Atrybut
background. Niektóre wersje Outlooka respektują<td background="...">, a dodanie go zajmuje chwilę. - VML. Dla pełnej kontroli w klasycznym Outlooku opakuj treść w prostokąt VML z wypełnieniem obrazem wewnątrz komentarza warunkowego. To działa, ale jest rozwlekłe, wrażliwe na dokładne wymiary i łatwo się psuje przy zmianie projektu.
Warstwowy fallback dla komórki z tłem wygląda tak:
<td align="center" bgcolor="#1A1A2E"
background="https://example.com/hero.jpg"
style="background: url('https://example.com/hero.jpg') center / cover no-repeat;
background-color: #1A1A2E; padding: 48px 24px;">
<!-- nagłówek i przycisk -->
</td>
Praktyczna zasada: jeśli tekst na banerze jest kluczowy, rozważ zostawienie go jako żywego tekstu HTML na jednolitym kolorze, zamiast w ogóle polegać na obrazie w tle. Jeśli projekt zależy od obrazu, przetestuj go konkretnie w klasycznym Outlooku.
Przyciski bulletproof
Przyciski z obrazków znikają, gdy obrazy są zablokowane, a przyciski ostylowane paddingiem na linku w Outlooku często tracą klikalny obszar. Bezpieczniejszy wzorzec to przycisk zbudowany z komórki tabeli z kolorem tła, jawną wysokością i line-height równym tej wysokości, żeby etykieta była wyśrodkowana w pionie:
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td align="center" valign="middle" height="48" bgcolor="#2563EB"
style="height: 48px; border-radius: 6px;">
<a href="https://example.com"
style="display: block; padding: 0 28px; font-family: Arial, sans-serif;
font-size: 16px; line-height: 48px; color: #FFFFFF;
text-decoration: none; white-space: nowrap;">
Shop the sale
</a>
</td>
</tr>
</table>
W Outlooku rogi będą kwadratowe, co jest akceptowalną degradacją. Wszędzie indziej przycisk zachowa zaokrąglony kształt. Dokładniej o błędach typowych dla Outlooka piszemy w artykule o typowych problemach z HTML email w Outlooku.
HTML email w Gmailu: sanityzacja, obsługa CSS i przycinanie
Gmail ma znacznie większe możliwości niż klasyczny Outlook, ale rządzi się własnymi prawami. Ponieważ tak wielu subskrybentów czyta maile w webowej i mobilnej aplikacji Gmaila, zasługuje on na osobną uwagę.
Co obsługuje Gmail
- Osadzone bloki
<style>w<head>są obsługiwane we własnych aplikacjach Gmaila — webowej i mobilnej — łącznie z media queries. To właśnie umożliwia tam responsywne maile. - Selektory klas i ID działają, choć Gmail po cichu przepisuje nazwy klas.
- Popularne właściwości CSS dotyczące koloru, typografii, paddingu, obramowań i teł zasadniczo działają bez problemu.
Na czym Gmail najczęściej łapie
- Jeden błąd może wyrzucić cały blok stylów. Jeśli parserowi Gmaila coś się nie spodoba w Twoim tagu
<style>, może odrzucić go w całości. Utrzymuj osadzony CSS w prostocie i waliduj go. - Konta spoza Gmaila w aplikacjach Gmail (np. adres służbowy albo od innego dostawcy dodany do aplikacji Gmail) mogą mieć słabszą obsługę CSS niż natywne konta Gmail. Tu Twoją siatką bezpieczeństwa są style inline.
- Limity rozmiaru. Gmail przycina wiadomości, których HTML przekracza mniej więcej 102 KB, i pokazuje link „Wyświetl całą wiadomość”. Wszystko po cięciu — często łącznie z linkiem do wypisania się i pikselem śledzącym — jest ukryte, dopóki czytelnik nie kliknie.
- Obrazy są proxowane. Gmail serwuje obrazy przez własne serwery, więc adresy URL obrazów muszą być publicznie dostępne.
Jak zmieścić się pod limitem przycinania
Limit dotyczy kodu HTML, a nie obrazów, które wczytują się osobno. Żeby bezpiecznie się pod nim zmieścić:
- Usuwaj nieużywany CSS i powtarzające się deklaracje inline, o ile pozwala na to Twój workflow.
- Unikaj mocno zduplikowanego kodu, np. osobnych wersji desktopowej i mobilnej tego samego bloku.
- Pilnuj tego, co dokłada Twoje ESP: parametry śledzące przy każdym linku i wrappery szablonów zwiększają rozmiar.
- Sprawdzaj końcowy rozmiar HTML, który faktycznie wysyła ESP, a nie tylko pliku, który wyeksportowałeś.
Klienty mobilne i responsywne maile
Większość maili otwiera się dziś na telefonach, więc responsywność to część zgodności, a nie dodatek.
Media queries z fallbackiem
Popularne podejście to układ o szerokości desktopowej, który poniżej breakpointu, zwykle tuż pod szerokością treści, przełącza się na jedną kolumnę:
@media only screen and (max-width: 598px) {
.mob-full { width: 100% !important; max-width: 100% !important; }
.mob-stack { display: block !important; width: 100% !important; }
.mob-pad { padding-left: 16px !important; padding-right: 16px !important; }
}
Ponieważ niektóre klienty ignorują media queries, układ desktopowy musi pozostać czytelny, gdy wyświetla się na małym ekranie. Układ 600px, który proporcjonalnie się zmniejsza, jest dużo lepszy niż taki, który wylewa się na boki.
Mobilne szczegóły, które mają znaczenie
- Rozmiar tekstu. Dla tekstu głównego używaj co najmniej 14px. iOS Mail potrafi sam powiększyć tekst mniejszy niż ok. 13px, co może rozbić układ, a ustawienie
-webkit-text-size-adjustpomaga to kontrolować. - Automatyczne formatowanie Apple. Meta tag
x-apple-disable-message-reformattingpowstrzymuje Apple Mail przed nieoczekiwaną zmianą rozmiaru treści. - Meta tag viewport. Dodaj go, żeby klienty mobilne poprawnie skalowały maila.
- Obszary dotyku. Przyciski powinny być na tyle duże, żeby wygodnie się je klikało, a szerokie przyciski powinny na małych ekranach rozszerzać się na całą szerokość.
- Obrazy. Używaj atrybutów
widthz wartością desktopową orazmax-width: 100%iheight: autodla obrazów, które mają się zmniejszać.
Jeśli projektujesz w Figmie, nasz poradnik o responsywnym projektowaniu maili w Figmie pokazuje, jak ustawić ramki, żeby czysto przekładały się na złożone układy mobilne.
Tryb ciemny w mailach: trzy zachowania, na które musisz się przygotować
Tryb ciemny to najnowsze duże wyzwanie dla zgodności, a do tego podchwytliwe, bo klienty obsługują go różnie. Ogólnie dzielą się na trzy grupy:
| Zachowanie | Co się dzieje | Twoja kontrola |
|---|---|---|
| Bez zmian | Mail renderuje się dokładnie tak, jak go zaprojektowano. | Pełna |
| Częściowa inwersja | Jasne tła są przyciemniane, a ciemny tekst rozjaśniany; obszary już ciemne zwykle zostają bez zmian. | Ograniczona |
| Pełna inwersja | Większość kolorów jest odwracana, łącznie z tymi, które celowo zrobiłeś ciemne. | Bardzo ograniczona |
Klienty respektujące media query prefers-color-scheme, takie jak Apple Mail, pozwalają dostarczyć własną ciemną paletę. Inne, w tym kilka aplikacji Gmail i Outlook, stosują własne zmiany kolorów bez względu na to, co mówi Twój CSS. To, jak zachowuje się konkretny klient, może się zmieniać między wersjami aplikacji, więc testowanie wygrywa z zapamiętywaniem listy.
Włączenie obsługi tam, gdzie jest dostępna
Tam, gdzie klient respektuje Twoje style, możesz zadeklarować, że mail obsługuje oba schematy, i dostarczyć ciemne nadpisania:
<meta name="color-scheme" content="light dark">
<meta name="supported-color-schemes" content="light dark">
<style>
@media (prefers-color-scheme: dark) {
.dm-bg { background-color: #121212 !important; }
.dm-text { color: #EDEDED !important; }
}
</style>
Traktuj to jako ulepszenie. Wiele klientów to zignoruje i zastosuje własne poprawki.
Projektowanie tak, żeby inwersja nie zaszkodziła
Ponieważ nie możesz w pełni kontrolować klientów odwracających kolory, najpewniejszą strategią jest projektowanie grafik, które przetrwają zmiany kolorów:
- Używaj przezroczystych PNG do logo i ikon, żeby nie siedziały w białym prostokącie na ciemnym tle.
- Dodaj cienki jasny kontur lub poświatę do ciemnych logo, żeby pozostały widoczne, gdy tło zrobi się ciemne.
- Unikaj tekstu wtopionego w obrazy, gdzie to możliwe. Żywy tekst dopasowuje się do trybu ciemnego; tekst na obrazie — nie.
- Nie polegaj wszędzie na czystej czerni i czystej bieli. Lekko złamane wartości często łagodniej znoszą inwersję.
- Sprawdź kolory marki w obu motywach. Kolor, który ma dobry kontrast na bieli, po inwersji może stać się trudny do odczytania.
Dobre praktyki projektowania maili FigMail zawierają te wskazówki dotyczące grafik na tryb ciemny i warto je zastosować w Figmie, zanim cokolwiek wyeksportujesz.
Fonty, obrazy i inne szczegóły międzyklientowe
Fonty webowe i fonty zastępcze
Własne fonty wczytują się w Apple Mail, iOS Mail i kilku innych klientach, ale nie w klasycznym Outlooku ani w części klientów webowych. Bezpieczne podejście:
- Wczytaj font przez
<link>lub@importw<head>. - Zastosuj własny font przez klasę w osadzonych stylach.
- W inline'owym
font-familyzostaw tylko fonty web-safe, np.Arial, Helvetica, sans-serifalbo'Times New Roman', Times, serif.
<style>
.font-brand { font-family: 'Fira Sans', Arial, sans-serif !important; }
</style>
<div class="font-brand"
style="font-family: Arial, Helvetica, sans-serif; font-size: 16px; line-height: 24px;">
Brand font where supported, Arial everywhere else.
</div>
Dzięki temu klienty obsługujące fonty webowe dostają krój Twojej marki, a Outlook przechodzi na Arial zamiast na Times New Roman.
Obrazy
- Projektuj w 1x (600px szerokości) i eksportuj obrazy w 2x, żeby były ostre na ekranach o dużej gęstości pikseli.
- Zawsze ustawiaj
widthw HTML, dodawajborder="0"i używajdisplay: block, żeby usunąć małą szczelinę, którą niektóre klienty dodają pod obrazami. - Pisz sensowne teksty
alt. Wiele klientów domyślnie blokuje obrazy, a tekst alternatywny to pierwsze, co widzą czytelnicy. - Ważne komunikaty, ceny i wezwania do działania trzymaj w żywym tekście, a nie tylko na obrazach.
Tekst preheadera
Preheader to fragment podglądu wyświetlany po temacie wiadomości. Jeśli go nie ustawisz, klienty pobiorą pierwszy tekst, jaki znajdą — a może to być „Zobacz w przeglądarce”. Ukryty span z preheaderem na początku body, a po nim znaki wypełniające, sprawiają, że podgląd jest czysty i zamierzony.
Odstępy bez marginesów
Ponieważ marginesy są w różnych klientach zawodne, odstępy zwykle tworzy się padding na komórkach tabeli albo osobnymi rzędami-spacerami. Ujemnych marginesów, popularnych w układach webowych, należy całkowicie unikać.
Jak testować w różnych klientach pocztowych
Żadna checklista nie zastąpi zobaczenia maila w prawdziwych klientach. Praktyczna rutyna testowa wygląda tak:
- Zwaliduj HTML. Sprawdź niezamknięte tagi i błędy składni CSS, bo jeden błąd może sprawić, że Gmail odrzuci Twoje style.
- Wyślij prawdziwe maile testowe na konta, które kontrolujesz: Gmail w przeglądarce i na mobile, Outlook na Windows i w przeglądarce, Apple Mail na Macu i iPhonie oraz każdy klient, z którego intensywnie korzystają Twoi odbiorcy.
- Użyj serwisu do podglądu maili. Dedykowane narzędzia do renderowania w jednym przebiegu generują zrzuty ekranu dla wielu kombinacji klientów, urządzeń i trybu ciemnego. Oszczędzają czas, choć kilka sprawdzeń w prawdziwych skrzynkach i tak warto zrobić.
- Przetestuj osobno tryb ciemny. Przełącz urządzenia na tryb ciemny i przejrzyj te same wysyłki jeszcze raz.
- Przetestuj z wyłączonymi obrazami. Upewnij się, że wiadomość ma sens na podstawie samych tekstów alternatywnych i żywego tekstu.
- Sprawdź rozmiar wiadomości, którą faktycznie wysyła ESP, żeby trzymać się z dala od przycinania w Gmailu.
- Kliknij każdy link i przycisk przynajmniej w jednym kliencie desktopowym i jednym mobilnym.
Analityka Twojego ESP może pokazać, z jakich klientów faktycznie korzystają subskrybenci. Skup ręczne testy na kilku najważniejszych, a długi ogon zostaw narzędziu do podglądu.
Szybka checklista przed wysyłką
- Układ tabelaryczny z wrapperem o stałej szerokości dla Outlooka
- Style inline na każdym widocznym elemencie
- Fallbacki
bgcolordla każdego koloru tła, obrazu i gradientu - Brak
colspan,rowspan, ujemnych marginesów ioverflow - Przyciski bulletproof oparte na tabelach
- Fonty zastępcze web-safe dla własnych fontów
- Responsywne media queries plus układ, który czyta się także bez nich
- Logo i ikony przyjazne dla trybu ciemnego
- Ustawiony tekst preheadera
- Rozmiar HTML wyraźnie poniżej limitu przycinania
Jak FigMail pomaga w zgodności HTML email
Ręczne kodowanie wszystkich tych wzorców jest powolne, a gdy goni termin, łatwo o któryś zapomnieć. FigMail to wtyczka do Figmy, która zamienia ramkę z Auto Layout w tabelaryczny HTML email według reguł zbudowanych wokół opisanych wyżej problemów ze zgodnością. Zgodnie z regułami, których przestrzega generator, obejmuje to:
- Strukturę tabelaryczną ze stylami inline i zresetowanymi atrybutami tabel
- Warunkowy wrapper MSO na brak obsługi
max-widthw Outlooku oraz ustawienia Outlooka w<head> - Fallbacki z atrybutami
bgcoloribackgrounddla obrazów w tle oraz fallback w kolorze średnim dla gradientów - Przyciski oparte na tabelach ze zgodnymi
heightiline-height - Odstępy z paddingów i spacerów zamiast marginesów, bez
colspanirowspan - Media queries, które na mobile składają kolumny i zmieniają rozmiar elementów
- Google Fonts podłączone przez klasy, z fontami zastępczymi web-safe zostawionymi inline dla Outlooka
- Meta tagi wyłączające przeformatowanie przez Apple i viewport oraz ukryty preheader
Niektóre rzeczy wciąż zależą od Twojego projektu. FigMail nie zastępuje testów, rozbudowane układy z tłami mogą nadal wymagać ręcznego sprawdzenia w klasycznym Outlooku, a efekty w trybie ciemnym mocno zależą od tego, jak przygotujesz logo i obrazy. Dlatego strona z dobrymi praktykami zaleca Auto Layout, szerokość 600px, fonty web-safe, przezroczyste grafiki i unikanie złożonych obrazów w tle, gdy liczy się obsługa Outlooka.
Co dalej
Jeśli projektujesz maile w Figmie, najszybszy sposób, żeby zobaczyć te wzorce w praktyce, to wyeksportować jedną z własnych ramek i przepuścić ją przez swoje zwykłe testy.
- Przeczytaj, jak działa FigMail, i zajrzyj do przeglądu funkcji.
- Przygotuj plik zgodnie z dobrymi praktykami projektowania maili i zobacz, jak projektować maile HTML w Figmie.
- Wyślij wynik do swojego ESP, np. Mailchimp, Klaviyo lub SendGrid, albo otwórz go w edytorze Blocks, żeby wizualnie poprawić teksty i obrazy.
- Zainstaluj wtyczkę FigMail i wypróbuj ją w planie Free, który obejmuje 3 generowania miesięcznie. Płatne plany znajdziesz w cenniku.
Zamień ramkę z Figmy w HTML email
Zainstaluj wtyczkę FigMail i przekonwertuj pierwsze maile za darmo.
Pobierz wtyczkę do Figmy