Problemy z HTML email w Outlooku — typowe błędy i poprawki
Praktyczny poradnik o błędach HTML email w Outlooku: rozjechany układ, brak tła, nieobsługiwany CSS i bezpieczne dla Outlooka fallbacki, które generuje FigMail.
Jeśli wystarczająco długo budujesz HTML email, uczysz się, że „u mnie w przeglądarce wygląda dobrze” znaczy bardzo niewiele. Outlook dla Windows to klient, który najczęściej psuje układ działający wszędzie indziej, a jego błędy układają się w kilka wyraźnych wzorców. Ten poradnik omawia najczęstsze problemy z HTML email w Outlooku, wyjaśnia, skąd się biorą, i pokazuje poprawki, które sprawdzają się na produkcji.
Dlaczego Outlook renderuje maile inaczej
Większość klientów pocztowych renderuje HTML silnikiem przeglądarki. Apple Mail używa WebKit, a Gmail i nowsze aplikacje Outlook działają w przeglądarce. Klasyczny Outlook dla Windows (wersje desktopowe od Outlooka 2007 wzwyż) jest inny: renderuje maile silnikiem układu Microsoft Word.
Word powstał do składania dokumentów, a nie stron internetowych. Dlatego spora część nowoczesnego CSS jest ignorowana albo obsługiwana tylko częściowo. Ten jeden fakt wyjaśnia niemal każdy błąd Outlooka, na jaki trafisz:
- CSS układu, taki jak
max-width,float, flexbox i grid, jest zawodny lub ignorowany. - Odstępy przez
marginipaddingzachowują się różnie w zależności od elementu, na którym się znajdują. - Obrazy w tle i gradienty w CSS nie są renderowane na większości elementów.
- Dekoracyjny CSS, taki jak
border-radiusibox-shadow, jest pomijany. - Fonty webowe nie są wczytywane, a źle ułożony stos fontów może skończyć się na Times New Roman.
Warto też wiedzieć, z którym Outlookiem masz do czynienia. „Outlook” to kilka produktów o bardzo różnym renderowaniu:
| Klient | Silnik renderujący | Typowe zachowanie |
|---|---|---|
| Outlook 2007–2019, Microsoft 365 desktop (Windows) | Microsoft Word | Większość błędów z tego poradnika |
| Nowy Outlook dla Windows | Oparty na przeglądarce | Blisko nowoczesnej poczty webowej |
| Outlook w przeglądarce (Outlook.com) | Przeglądarka | Dobra obsługa, z częściowym przepisywaniem CSS |
| Outlook dla Mac | WebKit | Podobnie jak Apple Mail |
| Outlook dla iOS i Androida | Natywny / web view | Zasadniczo dobra obsługa |
Gdy ludzie mówią o problemach z renderowaniem maili w Outlooku, prawie zawsze mają na myśli wersje desktopowe oparte na Wordzie. Wiele firm wciąż z nich korzysta, więc każdy mail, który ma wyglądać profesjonalnie, musi je uwzględniać.
Problem 1: Układ się rozpada albo rozciąga na całą szerokość
Objaw: Twój mail o szerokości 600px rozlewa się na cały panel odczytu Outlooka albo kolumny, które w innych klientach stoją obok siebie, składają się, nachodzą na siebie lub wychodzą poza kontener.
Przyczyna: Outlook ignoruje max-width i nie obsługuje float, flexboxa ani CSS grid. Układ zbudowany z elementów div i nowoczesnego CSS nie ma niczego, czego Outlook mógłby się uchwycić.
Poprawka: Zbuduj strukturę z tabel i opakuj główny kontener w tabelę o stałej szerokości widoczną tylko dla Outlooka. Outlook rozumie komentarze warunkowe MSO, które inne klienty traktują jak zwykłe komentarze i pomijają.
<!--[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;">
<tr>
<td>
<!-- Treść maila -->
</td>
</tr>
</table>
<!--[if (gte mso 9)|(IE)]>
</td></tr></table>
<![endif]-->
Nowoczesne klienty używają płynnej tabeli z max-width. Outlook widzi „ghost table” o stałej szerokości 600px i utrzymuje maila w odpowiedniej szerokości.
Rzędy z wieloma kolumnami
Ta sama idea działa dla kolumn. Popularny responsywny wzorzec używa divów inline-block, żeby kolumny składały się na mobile, oraz tabeli tylko dla Outlooka, która ustawia je obok siebie na desktopie:
<!--[if (gte mso 9)|(IE)]>
<table border="0" cellspacing="0" cellpadding="0"><tr><td width="300">
<![endif]-->
<div style="display: inline-block; width: 300px; vertical-align: top;">
<!-- Kolumna 1 -->
</div><!--[if (gte mso 9)|(IE)]></td><td width="300"><![endif]--><div style="display: inline-block; width: 300px; vertical-align: top;">
<!-- Kolumna 2 -->
</div>
<!--[if (gte mso 9)|(IE)]>
</td></tr></table>
<![endif]-->
Liczą się tu dwa szczegóły. Szerokości kolumn w tabeli warunkowej muszą być równe szerokościom divów, a między zamykającym </div> a kolejną kolumną nie może być białych znaków, bo elementy inline-block traktują je jako widoczną szczelinę.
Unikaj colspan i rowspan
Scalone komórki to kolejne źródło rozsypanych siatek w niektórych wersjach Outlooka. Gdy sekcja potrzebuje innej struktury kolumn, zagnieźdź nową tabelę w komórce zamiast używać colspan czy rowspan.
Problem 2: Odstępy są złe, podwojone albo ich brak
Objaw: Przerwy między sekcjami wyglądają w Outlooku inaczej, akapity dostają dodatkowe odstępy albo ustawione marginesy w ogóle nie działają.
Przyczyna: Obsługa margin w Outlooku jest niespójna, Outlook dodaje własne domyślne odstępy do tagów p i nagłówków, a padding na elementach div obsługuje słabo.
Poprawka: Ustawiaj odstępy na komórkach tabeli.
- Używaj
paddingna elementachtddla odstępów wewnątrz sekcji. To najbardziej niezawodna metoda we wszystkich klientach. - Unikaj
marginnadiv,piimg. Typowym bezpiecznym wyjątkiem jestmargin: 0 autodo wyśrodkowania tabeli. - Resetuj domyślne ustawienia każdej tabeli:
cellpadding="0" cellspacing="0" border="0". - Dla pionowych przerw, które nie są w komórce, używaj rzędu-spacera z jawną wysokością.
<table cellpadding="0" cellspacing="0" border="0" width="100%">
<tr>
<td style="padding: 32px 24px;">
<!-- Treść -->
</td>
</tr>
</table>
Stałe wysokości plus padding
Subtelny błąd bierze się z nadania komórce jednocześnie stałej height i pionowego paddingu. Końcowa wysokość to suma obu, a Outlook może wyrenderować ją inaczej niż pozostałe klienty. W blokach z tekstem lub tłem ustawiaj rozmiar wyłącznie paddingiem i zostaw wysokość automatyczną. Stałe wysokości zachowaj dla spacerów.
Problem 3: Znikają obrazy w tle i gradienty
Objaw: Baner hero z tekstem na zdjęciu pokazuje w Outlooku tylko zwykły tekst na białym tle. Przyciski i sekcje z gradientem zamieniają się w płaskie bloki albo całkiem tracą tło.
Przyczyna: Silnik Worda w Outlooku nie renderuje CSS-owego background-image ani gradientów CSS na większości elementów.
Poprawka: Nakładaj fallbacki warstwami, żeby każdy klient dostał coś sensownego:
- Ustaw jednolity
bgcolorna komórce. Ten kolor pokazuje każdy klient. - Dodaj na
tdatrybut HTMLbackgroundz adresem obrazu. Niektóre wersje Outlooka go odczytują. - Dodaj CSS-owe
backgrounddla nowoczesnych klientów. - Dla gradientów dodaj
background-colorpasujący do ogólnego tonu gradientu, żeby Outlook pokazał zbliżony jednolity kolor zamiast niczego.
<td bgcolor="#1E3A5F"
background="https://example.com/hero.jpg"
style="background: url('https://example.com/hero.jpg') center / cover no-repeat;
background-color: #1E3A5F; padding: 60px 24px;">
<!-- Nagłówek i przycisk -->
</td>
Upewnij się, że tekst ma wystarczający kontrast względem samego koloru zastępczego. Jeśli tekst jest biały, fallback powinien być ciemny.
Gdy potrzebujesz obrazu w desktopowym Outlooku: VML
Najpewniejszy sposób, żeby pokazać w Outlooku opartym na Wordzie obraz w tle za żywym tekstem, to VML (Vector Markup Language) — stary format Microsoftu, który Outlook wciąż renderuje. Umieszczasz kształt VML, np. v:rect z v:fill typu frame, wewnątrz komentarza warunkowego MSO, a treść wkładasz do v:textbox.
<!--[if gte mso 9]>
<v:rect xmlns:v="urn:schemas-microsoft-com:vml" fill="true" stroke="false"
style="width:600px;height:300px;">
<v:fill type="frame" src="https://example.com/hero.jpg" color="#1E3A5F" />
<v:textbox inset="0,0,0,0">
<![endif]-->
<div>
<!-- Nagłówek i przycisk -->
</div>
<!--[if gte mso 9]>
</v:textbox>
</v:rect>
<![endif]-->
VML wymaga stałych wymiarów w pikselach, dokłada sporo kodu i łatwo w nim o błąd. Używaj go tam, gdzie obraz w tle naprawdę niesie projekt. W wielu przypadkach jednolity kolor zastępczy albo spłaszczony obraz z tekstem zostawionym pod nim jako żywy HTML to prostszy i bezpieczniejszy wybór.
Problem 4: Zaokrąglone rogi, cienie i przyciski
Objaw: Zaokrąglone przyciski stają się kwadratowe, cienie znikają, a przyciski z linku z paddingiem są klikalne tylko na samym tekście.
Przyczyna: Outlook nie obsługuje border-radius ani box-shadow i ignoruje większość paddingu na inline'owych elementach a.
Poprawka: Buduj przyciski jako komórkę tabeli z kolorem tła i umieszczaj w niej link:
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td align="center" bgcolor="#2563EB" style="border-radius: 6px;">
<a href="https://example.com"
style="display: block; padding: 14px 28px; font-family: Arial, sans-serif;
font-size: 16px; line-height: 20px; color: #FFFFFF;
text-decoration: none; white-space: nowrap;">
Shop now
</a>
</td>
</tr>
</table>
W Outlooku ten przycisk będzie miał kwadratowe rogi, co zwykle jest akceptowalnym kompromisem. white-space: nowrap trzyma etykietę w jednej linii, a display: block na linku sprawia, że w obsługujących to klientach klikalna jest większa część przycisku. Jeśli zaokrąglone rogi w Outlooku są twardym wymogiem, może je narysować VML-owy v:roundrect — kosztem większej ilości kodu do utrzymania.
Nie polegaj na cieniach w niczym ważnym. Jeśli karta potrzebuje wizualnego oddzielenia, użyj obramowania albo zmiany koloru tła.
Problem 5: Fonty zamieniają się w Times New Roman
Objaw: Twój czysty bezszeryfowy nagłówek pojawia się w Outlooku w foncie szeryfowym.
Przyczyna: Outlook oparty na Wordzie nie wczytuje fontów webowych. Gdy trafia na stos fontów, którego nie potrafi rozwiązać — zwłaszcza gdy nazwa własnego fontu jest w inline'owym font-family — może przejść na Times New Roman zamiast na kolejny font ze stosu.
Poprawka:
- Zawsze kończ stos fontów fontem web-safe, takim jak Arial, Helvetica, Verdana czy Georgia, oraz rodziną ogólną.
- Wczytuj własne fonty przez
@importlub taglinkdla klientów, które je obsługują. - Na elementach wrażliwych w Outlooku zostaw w inline'owym
font-familytylko fonty web-safe, a własny font stosuj przez klasę w bloku<style>, który Outlook zignoruje. - Sprawdzaj interlinię. Outlook potrafi inaczej renderować
line-height, więc ustawiaj ją jawnie w pikselach na elementach tekstowych.
<style>
.heading { font-family: 'Montserrat', Arial, sans-serif !important; }
</style>
<div class="heading" style="font-family: Arial, sans-serif; font-size: 28px; line-height: 34px;">
Spring collection is here
</div>
Outlook pokaże Arial. Klienty, które wczytują fonty webowe, pokażą Montserrat.
Problem 6: Obrazy, które się rozmywają, rozciągają lub zostawiają szczeliny
Objaw: Obrazy wyświetlają się w pełnym rozmiarze pliku zamiast w zamierzonej szerokości, obrazy retina są ogromne albo pod obrazami pojawiają się cienkie szczeliny.
Przyczyna: Outlook nie respektuje niezawodnie CSS-owego width ani max-width na obrazach, więc wraca do rzeczywistego rozmiaru obrazu w pikselach, chyba że atrybut HTML width mówi inaczej. Obrazy są też domyślnie elementami inline, co zostawia pod nimi miejsce na dolne wydłużenia liter.
Poprawka:
- Zawsze ustawiaj atrybut
widthw pikselach na zamierzoną szerokość wyświetlania, np.width="600"dla obrazu retina o szerokości 1200px. - Dodaj
style="display: block;", żeby usunąć szczelinę pod obrazami. - Dodaj
border="0", żeby obrazy z linkiem nie dostały obramowania. - Używaj
max-widthw stylu dla płynnego zachowania w nowoczesnych klientach. - Dodaj blok ustawień Office w
<head>, żeby Outlook dopuszczał obrazy PNG i używał standardowej gęstości pikseli:
<!--[if gte mso 9]>
<xml>
<o:OfficeDocumentSettings>
<o:AllowPNG/>
<o:PixelsPerInch>96</o:PixelsPerInch>
</o:OfficeDocumentSettings>
</xml>
<![endif]-->
Ustawienie PixelsPerInch pomaga przy dobrze znanym problemie, w którym skalowanie ekranu w Windows sprawia, że Outlook nierówno zmienia rozmiar obrazów i szerokości.
Problem 7: Niespodzianki w trybie ciemnym
Tryb ciemny w Outlooku, podobnie jak w innych klientach, może zmienić Twoje kolory. Jasne tła mogą stać się ciemne, a ciemny tekst jasny, ale obrazy zostają bez zmian. Klasyczny efekt: czarne logo na przezroczystym tle znika na ciemnym tle.
Praktyczne zabezpieczenia:
- Używaj przezroczystych PNG do logo i ikon, a ciemnym logo dodaj jasny obrys lub kontur, żeby pozostały widoczne na ciemnym tle.
- Unikaj czarnego tekstu na przezroczystym tle. Umieszczaj tekst w komórce z jawnym kolorem tła.
- Przed wysyłką przetestuj kluczowe kolory w motywie jasnym i ciemnym.
Dokładniej omawiamy to w naszym przewodniku po zgodności HTML email.
Obsługa CSS w Outlooku: krótka ściągawka
Ta tabela podsumowuje obsługę CSS w desktopowych wersjach Outlooka opartych na Wordzie wraz z typowym obejściem. Obsługa różni się między wersjami, więc traktuj ją jako punkt wyjścia i testuj.
| Funkcja | Desktopowy Outlook (Windows) | Obejście |
|---|---|---|
max-width |
Nieobsługiwane | Ghost table MSO o stałej szerokości |
float, flexbox, grid |
Nieobsługiwane | Tabele, inline-block plus tabele MSO |
margin |
Niespójne | padding na td, rzędy-spacery |
padding na div |
Zawodne | padding na td |
background-image (CSS) |
Nieobsługiwane na większości elementów | bgcolor, atrybut background, VML |
| Gradienty | Nieobsługiwane | Jednolity kolor zastępczy, VML |
border-radius |
Nieobsługiwane | Zaakceptuj kwadratowe rogi albo VML |
box-shadow |
Nieobsługiwane | Obramowania lub kontrast kolorów |
| Fonty webowe | Nie są wczytywane | Stos fontów zastępczych web-safe |
| Media queries | Nieobsługiwane | Układ desktop-first, który działa bez nich |
colspan / rowspan |
Mogą psuć układ | Zagnieżdżone tabele |
Checklista testów w Outlooku
Nawet dobrze zbudowany kod wymaga sprawdzenia w prawdziwym kliencie przed dużą wysyłką. Prosta rutyna:
- Testuj właściwe wersje. Obejmij przynajmniej jeden desktopowy Outlook oparty na Wordzie, a także Outlooka w przeglądarce i na mobile. Użyj prawdziwej instalacji albo serwisu do testowania maili, który renderuje rzeczywiste klienty.
- Sprawdź szerokość. Mail powinien utrzymać zamierzoną szerokość w szerokim panelu odczytu.
- Sprawdź każde tło. Potwierdź, że pojawiają się kolory zastępcze, a tekst pozostaje czytelny bez obrazu.
- Sprawdź fonty i interlinię. Wypatruj Times New Roman i linii zbyt ściśniętych lub zbyt luźnych.
- Sprawdź przyciski. Upewnij się, że są widoczne, czytelne i klikalne.
- Sprawdź tryb ciemny. Przyjrzyj się logo, ikonom i każdemu tekstowi na przezroczystym tle.
- Sprawdź przy różnym skalowaniu ekranu. Skalowanie Windows powyżej 100% obnaża błędy szerokości i rozmiarów obrazów.
Jak FigMail radzi sobie z Outlookiem
FigMail to wtyczka do Figmy, która zamienia ramkę z Figmy w tabelaryczny HTML email. Wiele poprawek z tego poradnika to część reguł, których przestrzega jego generator AI, więc nie musisz dodawać ich ręcznie:
- Struktura tabelaryczna. Układy są budowane z zagnieżdżonych tabel, a nie z divów czy flexboxa, i bez scalonych komórek.
- Warunkowe wrappery MSO. Główny kontener dostaje tabelę o stałej szerokości dla Outlooka, a rzędy z wieloma kolumnami korzystają z warunkowych tabel Outlooka, więc kolumny zostają obok siebie w desktopowym Outlooku i składają się na mobile.
- Bez marginesów. Odstępy powstają z paddingu na komórkach tabeli i elementów-spacerów.
- Fallbacki teł. Kolory tła są ustawiane przez
bgcolor, obrazy w tle dostają atrybut HTMLbackgroundobok CSS, a gradienty — pasujący jednolity kolor zastępczy. - Ustawienia Office w nagłówku. Blok
AllowPNGiPixelsPerInchjest dołączony. - Fonty zastępcze. Możesz używać Google Fonts, a FigMail ustawia stosy fontów zastępczych web-safe, żeby Outlook nie spadał do domyślnego fontu szeryfowego.
Dwa uczciwe zastrzeżenia. Po pierwsze, wynik FigMail opiera się na graceful degradation: zaokrąglone rogi i cienie będą w desktopowym Outlooku kwadratowe lub nieobecne, jak opisano wyżej. Po drugie, złożone efekty tła za żywym tekstem to najtrudniejszy przypadek dla Outlooka w każdym workflow, więc sprawdź te sekcje w prawdziwym kliencie Outlook przed wysyłką. Podgląd FigMail pozwala przełączać się między widokiem desktopowym, mobilnym i symulowanym trybem ciemnym oraz porównać wynik z projektem w Figmie, ale nie jest rendererem Outlooka.
Lepszy wynik dostajesz też wtedy, gdy sam projekt jest przyjazny dla maili. Używaj Auto Layout zamiast pozycjonowania absolutnego, trzymaj szerokość w okolicach 600px, unikaj nakładających się warstw i ujemnych odstępów, a przyciski buduj z Auto Layout zamiast z prostokąta z tekstem na wierzchu. Nasza strona z dobrymi praktykami zbiera to w jednym miejscu, a artykuł jak projektować maile HTML w Figmie dokładniej omawia stronę projektową.
Co dalej
Błędy Outlooka są przewidywalne, gdy wiesz, że biorą się z silnika Worda: buduj z tabel, trzymaj odstępy w komórkach, dawaj każdemu tłu fallback, używaj stosów fontów web-safe i testuj w prawdziwym kliencie.
Jeśli projektujesz maile w Figmie, możesz zainstalować wtyczkę FigMail i wypróbować ją na jednej z własnych ramek. Darmowy plan obejmuje 3 generowania miesięcznie, a płatne plany znajdziesz w cenniku. Żeby zobaczyć, co dzieje się między Twoją ramką a finalnym HTML, przeczytaj, jak to działa, albo przejrzyj dokumentację, gdzie opisaliśmy opcje podglądu, tłumaczenia i eksportu.
Zamień ramkę z Figmy w HTML email
Zainstaluj wtyczkę FigMail i przekonwertuj pierwsze maile za darmo.
Pobierz wtyczkę do Figmy