Problemi delle email HTML in Outlook — Cause e soluzioni
Guida pratica ai bug delle email HTML in Outlook: layout rotti, sfondi che spariscono, CSS non supportato e i fallback sicuri per Outlook che FigMail genera.
Se costruisci email HTML da abbastanza tempo, hai imparato che "nel mio browser si vede bene" significa ben poco. Outlook per Windows è il client che più facilmente rompe un layout che funziona ovunque altrove, e i suoi bug seguono pochi schemi chiari. In questa guida vediamo i problemi più comuni delle email HTML in Outlook, perché si verificano e quali soluzioni reggono davvero in produzione.
Perché Outlook visualizza le email in modo diverso
La maggior parte dei client email esegue il rendering dell'HTML con un motore da browser. Apple Mail usa WebKit, mentre Gmail e le app Outlook più recenti girano in un browser. Outlook classico per Windows (le versioni desktop da Outlook 2007 in poi) è diverso: visualizza le email con il motore di impaginazione di Microsoft Word.
Word è nato per impaginare documenti, non pagine web. Per questo gran parte del CSS moderno viene ignorata o supportata solo in parte. Questo singolo fatto spiega quasi tutti i bug delle email in Outlook che incontrerai:
- Il CSS di layout come
max-width,float, flexbox e grid è inaffidabile o ignorato. - Le spaziature con
marginepaddingsi comportano in modo diverso a seconda dell'elemento su cui si trovano. - Le immagini di sfondo CSS e i gradienti non vengono visualizzati sulla maggior parte degli elementi.
- Il CSS decorativo come
border-radiusebox-shadowviene scartato. - I web font non vengono caricati, e uno stack di font sbagliato può ripiegare su Times New Roman.
Vale anche la pena sapere con quale Outlook hai a che fare. "Outlook" comprende diversi prodotti con un rendering molto diverso:
| Client | Motore di rendering | Comportamento tipico |
|---|---|---|
| Outlook 2007–2019, Microsoft 365 desktop (Windows) | Microsoft Word | La maggior parte dei bug di questa guida |
| Nuovo Outlook per Windows | Basato su browser | Simile alle webmail moderne |
| Outlook sul web (Outlook.com) | Browser | Buon supporto, con qualche riscrittura del CSS |
| Outlook per Mac | WebKit | Simile ad Apple Mail |
| Outlook per iOS e Android | Vista nativa/web | Supporto generalmente buono |
Quando si parla di problemi di rendering delle email in Outlook, si intendono quasi sempre le versioni desktop basate su Word. Molte aziende le usano ancora, quindi qualsiasi email che debba sembrare professionale deve tenerne conto.
Problema 1: il layout si rompe o si allarga a tutta larghezza
Sintomo: la tua email da 600px si allarga su tutto il riquadro di lettura di Outlook, oppure le colonne che negli altri client stanno affiancate si impilano, si sovrappongono o escono dal contenitore.
Causa: Outlook ignora max-width e non supporta float, flexbox né CSS grid. Un layout costruito con elementi div e CSS moderno non offre a Outlook niente a cui aggrapparsi.
Soluzione: costruisci la struttura con le tabelle e racchiudi il contenitore principale in una tabella a larghezza fissa riservata a Outlook. Outlook capisce i commenti condizionali MSO, che gli altri client trattano come normali commenti e saltano.
<!--[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>
<!-- Contenuto dell'email -->
</td>
</tr>
</table>
<!--[if (gte mso 9)|(IE)]>
</td></tr></table>
<![endif]-->
I client moderni usano la tabella fluida con max-width. Outlook vede la "ghost table" fissa da 600px e mantiene l'email alla larghezza giusta.
Righe a più colonne
La stessa idea funziona per le colonne. Uno schema responsive comune usa div inline-block, così le colonne si impilano su mobile, più una tabella riservata a Outlook che le affianca su desktop:
<!--[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;">
<!-- Colonna 1 -->
</div><!--[if (gte mso 9)|(IE)]></td><td width="300"><![endif]--><div style="display: inline-block; width: 300px; vertical-align: top;">
<!-- Colonna 2 -->
</div>
<!--[if (gte mso 9)|(IE)]>
</td></tr></table>
<![endif]-->
Qui contano due dettagli. Tieni le larghezze delle colonne nella tabella condizionale uguali a quelle dei div ed evita spazi bianchi tra il </div> di chiusura e la colonna successiva, perché gli elementi inline-block trattano gli spazi bianchi come uno spazio visibile.
Evita colspan e rowspan
Le celle unite sono un'altra fonte di griglie rotte in alcune versioni di Outlook. Quando una sezione ha bisogno di una struttura di colonne diversa, annida una nuova tabella dentro una cella invece di usare colspan o rowspan.
Problema 2: spaziature sbagliate, raddoppiate o assenti
Sintomo: gli spazi tra le sezioni appaiono diversi in Outlook, i paragrafi prendono spazio in più, oppure i margini che hai impostato non hanno alcun effetto.
Causa: il supporto di Outlook a margin è incoerente, Outlook aggiunge le proprie spaziature predefinite ai tag p e ai titoli e gestisce male il padding sugli elementi div.
Soluzione: metti le spaziature sulle celle di tabella.
- Usa il
paddingsugli elementitdper lo spazio dentro le sezioni. È il metodo di spaziatura più affidabile tra i client. - Evita
marginsudiv,peimg.margin: 0 autoper centrare una tabella è la solita eccezione sicura. - Azzera i valori predefiniti su ogni tabella:
cellpadding="0" cellspacing="0" border="0". - Per gli spazi verticali che non stanno dentro una cella, usa una riga spaziatrice con altezza esplicita.
<table cellpadding="0" cellspacing="0" border="0" width="100%">
<tr>
<td style="padding: 32px 24px;">
<!-- Contenuto -->
</td>
</tr>
</table>
Altezze fisse più padding
Un bug subdolo nasce quando dai a una cella sia un'height fissa sia un padding verticale. L'altezza finale è la somma dei due, e Outlook può visualizzarla in modo diverso dagli altri client. Per i blocchi con testo o sfondo, imposta le dimensioni solo con il padding e lascia l'altezza automatica. Tieni le altezze fisse per gli spacer.
Problema 3: immagini di sfondo e gradienti spariscono
Sintomo: un banner hero con testo sopra una foto in Outlook mostra solo testo semplice su bianco. Pulsanti e sezioni con gradiente diventano blocchi piatti o perdono del tutto lo sfondo.
Causa: il motore Word di Outlook non visualizza background-image CSS né i gradienti CSS sulla maggior parte degli elementi.
Soluzione: stratifica i fallback, così ogni client riceve qualcosa di sensato:
- Imposta un
bgcolorpieno sulla cella. Tutti i client mostrano questo colore. - Aggiungi sul
tdl'attributo HTMLbackgroundcon l'URL dell'immagine. Alcune versioni di Outlook lo leggono. - Aggiungi il CSS
backgroundper i client moderni. - Per i gradienti, aggiungi un
background-colorche corrisponda al tono complessivo del gradiente, così Outlook mostra un colore pieno simile invece del nulla.
<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;">
<!-- Titolo e pulsante -->
</td>
Assicurati che il testo abbia abbastanza contrasto anche solo con il colore di fallback. Se il testo è bianco, il fallback deve essere scuro.
Quando ti serve l'immagine in Outlook desktop: VML
Il modo più affidabile per mostrare un'immagine di sfondo dietro del testo vivo in Outlook basato su Word è il VML (Vector Markup Language), un vecchio formato Microsoft che Outlook visualizza ancora. Inserisci una forma VML, come un v:rect con un v:fill di tipo frame, dentro un commento condizionale MSO, e metti il contenuto in un 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>
<!-- Titolo e pulsante -->
</div>
<!--[if gte mso 9]>
</v:textbox>
</v:rect>
<![endif]-->
Il VML richiede dimensioni fisse in pixel, aggiunge parecchio codice ed è facile sbagliarlo. Usalo dove un'immagine di sfondo regge davvero il design. In molti casi un fallback con colore pieno, o un'immagine appiattita con il testo mantenuto in HTML vivo subito sotto, è la scelta più semplice e sicura.
Problema 4: angoli arrotondati, ombre e pulsanti
Sintomo: i pulsanti arrotondati diventano squadrati, le ombre spariscono e i pulsanti fatti con link e padding sono cliccabili solo sul testo.
Causa: Outlook non supporta border-radius né box-shadow e ignora gran parte del padding sugli elementi a inline.
Soluzione: costruisci i pulsanti come una cella di tabella con colore di sfondo e mettici dentro il 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>
In Outlook questo pulsante avrà gli angoli squadrati, un compromesso di solito accettabile. white-space: nowrap tiene l'etichetta su una sola riga e display: block sul link rende cliccabile una parte maggiore del pulsante nei client che lo supportano. Se gli angoli arrotondati in Outlook sono un requisito irrinunciabile, un v:roundrect VML può disegnarli, al prezzo di più codice da mantenere.
Non affidarti alle ombre per niente di importante. Se una card ha bisogno di staccarsi visivamente, usa un bordo o un cambio di colore di sfondo.
Problema 5: i font ripiegano su Times New Roman
Sintomo: il tuo pulito titolo sans-serif in Outlook compare in un font con le grazie.
Causa: Outlook basato su Word non carica i web font. Quando incontra uno stack di font che non sa risolvere, soprattutto se il nome del font personalizzato è nel font-family inline, può ripiegare su Times New Roman invece che sul font successivo dello stack.
Soluzione:
- Chiudi sempre lo stack di font con un font web-safe, come Arial, Helvetica, Verdana o Georgia, e una famiglia generica.
- Carica i font personalizzati con
@importo con un taglinkper i client che li supportano. - Sugli elementi sensibili a Outlook, limita il
font-familyinline ai font web-safe e applica il font personalizzato tramite una classe nel blocco<style>, che Outlook ignorerà. - Controlla le interlinee. Outlook può visualizzare
line-heightin modo diverso, quindi impostala esplicitamente in pixel sugli elementi di testo.
<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 mostra Arial. I client che caricano i web font mostrano Montserrat.
Problema 6: immagini sfocate, deformate o con spazi vuoti
Sintomo: le immagini appaiono alla dimensione reale del file invece che alla larghezza prevista, le immagini Retina risultano enormi oppure compaiono sottili spazi vuoti sotto le immagini.
Causa: Outlook non rispetta in modo affidabile width o max-width CSS sulle immagini, quindi ripiega sulla dimensione reale in pixel dell'immagine, a meno che l'attributo HTML width non dica altro. Inoltre le immagini sono di default elementi inline, che lasciano sotto di sé lo spazio per i discendenti del testo.
Soluzione:
- Imposta sempre l'attributo
widthin pixel alla larghezza di visualizzazione prevista, per esempiowidth="600"per un'immagine Retina da 1200px. - Aggiungi
style="display: block;"per eliminare lo spazio sotto le immagini. - Aggiungi
border="0", così le immagini con link non ricevono un bordo. - Usa
max-widthnello stile per un comportamento fluido nei client moderni. - Includi nell'
<head>il blocco di impostazioni di Office, così Outlook accetta le immagini PNG e usa una densità di pixel standard:
<!--[if gte mso 9]>
<xml>
<o:OfficeDocumentSettings>
<o:AllowPNG/>
<o:PixelsPerInch>96</o:PixelsPerInch>
</o:OfficeDocumentSettings>
</xml>
<![endif]-->
L'impostazione PixelsPerInch aiuta con un problema ben noto, in cui il ridimensionamento dello schermo di Windows porta Outlook a ridimensionare immagini e larghezze in modo non uniforme.
Problema 7: sorprese con la dark mode
La dark mode di Outlook, come quella di altri client, può cambiare i tuoi colori. Gli sfondi chiari possono diventare scuri e il testo scuro chiaro, ma le immagini restano come sono. Il risultato classico è un logo nero su sfondo trasparente che sparisce su uno sfondo scuro.
Difese pratiche:
- Usa PNG trasparenti per loghi e icone e aggiungi un contorno chiaro ai loghi scuri, così restano visibili sugli sfondi scuri.
- Evita il testo nero su sfondo trasparente. Metti il testo in una cella con un colore di sfondo esplicito.
- Prova i tuoi colori principali sia nel tema chiaro sia in quello scuro prima di inviare.
Ne parliamo più a fondo nella nostra guida alla compatibilità delle email HTML.
Supporto CSS di Outlook: riferimento rapido
Questa tabella riassume il supporto CSS di Outlook nelle versioni desktop basate su Word, con la soluzione abituale. Il supporto varia da versione a versione, quindi consideralo un punto di partenza e testa.
| Funzionalità | Outlook desktop (Windows) | Soluzione |
|---|---|---|
max-width |
Non supportato | Ghost table MSO a larghezza fissa |
float, flexbox, grid |
Non supportati | Tabelle, inline-block più tabelle MSO |
margin |
Incoerente | padding sui td, righe spaziatrici |
padding sui div |
Inaffidabile | padding sui td |
background-image (CSS) |
Non supportato sulla maggior parte degli elementi | bgcolor, attributo background, VML |
| Gradienti | Non supportati | Colore pieno di fallback, VML |
border-radius |
Non supportato | Accetta gli angoli squadrati o usa il VML |
box-shadow |
Non supportato | Bordi o contrasto di colore |
| Web font | Non caricati | Stack di fallback web-safe |
| Media query | Non supportate | Layout desktop-first che funziona anche senza |
colspan / rowspan |
Possono rompere il layout | Tabelle annidate |
Una checklist di test per Outlook
Anche un codice ben costruito va controllato in un client reale prima di un invio importante. Una routine semplice:
- Testa le versioni giuste. Copri almeno un Outlook desktop basato su Word, oltre a Outlook sul web e su mobile. Usa un'installazione reale o un servizio di test email che visualizzi i client veri.
- Controlla la larghezza. L'email deve mantenere la larghezza prevista in un riquadro di lettura largo.
- Controlla ogni sfondo. Verifica che compaiano i colori di fallback e che il testo resti leggibile senza l'immagine.
- Controlla font e interlinee. Cerca Times New Roman e righe troppo strette o troppo larghe.
- Controlla i pulsanti. Assicurati che siano visibili, leggibili e cliccabili.
- Controlla la dark mode. Guarda loghi, icone e qualsiasi testo su sfondo trasparente.
- Controlla con diversi livelli di ridimensionamento dello schermo. Un ridimensionamento di Windows sopra il 100% fa emergere i bug di larghezza e di dimensione delle immagini.
Come FigMail gestisce Outlook
FigMail è un plugin Figma che converte un frame Figma in un'email HTML basata su tabelle. Molte delle soluzioni di questa guida fanno parte delle regole che segue il suo generatore AI, quindi non devi aggiungerle a mano:
- Struttura basata su tabelle. I layout sono costruiti con tabelle annidate, non con div o flexbox, e le celle unite vengono evitate.
- Wrapper condizionali MSO. Il contenitore principale riceve una tabella Outlook a larghezza fissa, e le righe a più colonne usano tabelle condizionali per Outlook, così le colonne restano affiancate in Outlook desktop e si impilano su mobile.
- Niente margini. Le spaziature si fanno con il padding sulle celle di tabella e con elementi spaziatori.
- Fallback per gli sfondi. I colori di sfondo sono impostati con
bgcolor, le immagini di sfondo ricevono l'attributo HTMLbackgroundinsieme al CSS e i gradienti un colore pieno di fallback corrispondente. - Impostazioni di Office nell'head. Il blocco
AllowPNGePixelsPerInchè incluso. - Fallback per i font. Puoi usare i Google Fonts, e FigMail imposta stack di fallback web-safe, così Outlook non ripiega su un serif predefinito.
Due avvertenze oneste. Primo, l'output di FigMail segue la logica della graceful degradation: in Outlook desktop angoli arrotondati e ombre saranno squadrati o assenti, come descritto sopra. Secondo, gli effetti di sfondo complessi dietro il testo vivo sono il caso più difficile per Outlook in qualsiasi workflow, quindi controlla quelle sezioni in un vero client Outlook prima di inviare. L'anteprima di FigMail ti permette di passare tra vista desktop, mobile e dark mode simulata e di confrontare il risultato con il tuo design Figma, ma non è un renderer di Outlook.
Ottieni anche un risultato migliore quando il design stesso è adatto alle email. Usa l'Auto Layout invece del posizionamento assoluto, tieni la larghezza intorno ai 600px, evita livelli sovrapposti e spaziature negative e costruisci i pulsanti con l'Auto Layout invece che con un rettangolo con sopra del testo. La nostra pagina delle best practice le raccoglie tutte in un unico posto, e come progettare email HTML in Figma approfondisce la parte di design.
Prossimi passi
I bug di Outlook sono prevedibili, una volta che sai che vengono dal motore di Word: costruisci con le tabelle, tieni le spaziature nelle celle, dai un fallback a ogni sfondo, usa stack di font web-safe e testa in un client reale.
Se progetti le tue email in Figma, puoi installare il plugin FigMail e provarlo su uno dei tuoi frame. Il piano gratuito include 3 generazioni al mese e i piani a pagamento sono nella pagina dei prezzi. Per vedere cosa succede tra il tuo frame e l'HTML finale, leggi come funziona, oppure consulta la documentazione per le opzioni di anteprima, traduzione ed export.
Trasforma il tuo frame Figma in un'email HTML
Installa il plugin FigMail e converti gratis le tue prime email.
Scarica il plugin Figma