Wszystkie artykuły
Technicznie 22 listopada 2026 10 min czytania

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 margin i padding zachowują 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-radius i box-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 padding na elementach td dla odstępów wewnątrz sekcji. To najbardziej niezawodna metoda we wszystkich klientach.
  • Unikaj margin na div, p i img. Typowym bezpiecznym wyjątkiem jest margin: 0 auto do 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:

  1. Ustaw jednolity bgcolor na komórce. Ten kolor pokazuje każdy klient.
  2. Dodaj na td atrybut HTML background z adresem obrazu. Niektóre wersje Outlooka go odczytują.
  3. Dodaj CSS-owe background dla nowoczesnych klientów.
  4. Dla gradientów dodaj background-color pasują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 @import lub tag link dla klientów, które je obsługują.
  • Na elementach wrażliwych w Outlooku zostaw w inline'owym font-family tylko 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 width w 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-width w 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:

  1. 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.
  2. Sprawdź szerokość. Mail powinien utrzymać zamierzoną szerokość w szerokim panelu odczytu.
  3. Sprawdź każde tło. Potwierdź, że pojawiają się kolory zastępcze, a tekst pozostaje czytelny bez obrazu.
  4. Sprawdź fonty i interlinię. Wypatruj Times New Roman i linii zbyt ściśniętych lub zbyt luźnych.
  5. Sprawdź przyciski. Upewnij się, że są widoczne, czytelne i klikalne.
  6. Sprawdź tryb ciemny. Przyjrzyj się logo, ikonom i każdemu tekstowi na przezroczystym tle.
  7. 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 HTML background obok CSS, a gradienty — pasujący jednolity kolor zastępczy.
  • Ustawienia Office w nagłówku. Blok AllowPNG i PixelsPerInch jest 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

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.