Wszystkie artykuły
Technicznie 22 listopada 2026 12 min czytania

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-width nie jest obsługiwane, więc płynne kontenery mogą rozciągać się na całe okno.
  • margin jest zawodny. Odstępy powinny pochodzić z padding na 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 background oraz jednolitego koloru zastępczego.
  • border-radius jest 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.
  • colspan i rowspan mogą 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-family moż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:

  1. Jednolity kolor zastępczy. Zawsze ustawiaj bgcolor na komórce, żeby tekst był czytelny, nawet jeśli obraz się nie pojawi.
  2. Atrybut background. Niektóre wersje Outlooka respektują <td background="...">, a dodanie go zajmuje chwilę.
  3. 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-adjust pomaga to kontrolować.
  • Automatyczne formatowanie Apple. Meta tag x-apple-disable-message-reformatting powstrzymuje 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 width z wartością desktopową oraz max-width: 100% i height: auto dla 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 @import w <head>.
  • Zastosuj własny font przez klasę w osadzonych stylach.
  • W inline'owym font-family zostaw tylko fonty web-safe, np. Arial, Helvetica, sans-serif albo '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 width w HTML, dodawaj border="0" i używaj display: 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:

  1. Zwaliduj HTML. Sprawdź niezamknięte tagi i błędy składni CSS, bo jeden błąd może sprawić, że Gmail odrzuci Twoje style.
  2. 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.
  3. 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ć.
  4. Przetestuj osobno tryb ciemny. Przełącz urządzenia na tryb ciemny i przejrzyj te same wysyłki jeszcze raz.
  5. Przetestuj z wyłączonymi obrazami. Upewnij się, że wiadomość ma sens na podstawie samych tekstów alternatywnych i żywego tekstu.
  6. Sprawdź rozmiar wiadomości, którą faktycznie wysyła ESP, żeby trzymać się z dala od przycinania w Gmailu.
  7. 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 bgcolor dla każdego koloru tła, obrazu i gradientu
  • Brak colspan, rowspan, ujemnych marginesów i overflow
  • 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-width w Outlooku oraz ustawienia Outlooka w <head>
  • Fallbacki z atrybutami bgcolor i background dla obrazów w tle oraz fallback w kolorze średnim dla gradientów
  • Przyciski oparte na tabelach ze zgodnymi height i line-height
  • Odstępy z paddingów i spacerów zamiast marginesów, bez colspan i rowspan
  • 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.

Zamień ramkę z Figmy w HTML email

Zainstaluj wtyczkę FigMail i przekonwertuj pierwsze maile za darmo.

Pobierz wtyczkę do Figmy

Czytaj dalej

Gotowy na lepsze maile?

Projektuj w Figmie, generuj z FigMail HTML gotowy do wysyłki i wysyłaj go z platformy mailingowej, której już używasz.