Tutti gli articoli
Tecnica 22 novembre 2026 12 min di lettura

Compatibilità email HTML 2026 — Outlook, Gmail e dark mode

Cosa deve sapere chi sviluppa email sulla compatibilità HTML: le stranezze di Outlook e il VML, il CSS in Gmail, la dark mode e i test prima dell'invio.

Un'email che nel tuo browser sembra perfetta può arrivare rotta nella inbox di un iscritto, perché ogni client email interpreta l'HTML a modo suo. In questa guida passiamo in rassegna i client che creano più problemi, il perché del loro comportamento e gli schemi pratici che mantengono leggibile una campagna ovunque. È scritta per marketer, designer e sviluppatori che vogliono meno sorprese dopo aver premuto invia.

Perché la compatibilità delle email HTML è ancora difficile

I browser si sono allineati su standard comuni anni fa. I client email no. Un'email viene renderizzata dal motore che usa il client del destinatario, e quei motori sono diversissimi tra loro:

  • Outlook per Windows (le versioni desktop classiche) esegue il rendering dell'HTML con il motore di impaginazione di Microsoft Word, non con un motore da browser.
  • Gmail fa passare il tuo markup attraverso un proprio sanitizer, riscrive i nomi delle classi e rimuove il CSS che non consente.
  • Apple Mail e iOS Mail usano WebKit e supportano gran parte del CSS moderno.
  • Webmail e app mobile aggiungono ciascuna i propri wrapper, stili e comportamenti per la dark mode sopra il tuo codice.

Non puoi controllare quale client usa un iscritto, quindi la compatibilità tra client email si riduce a un principio: scrivi un markup che anche il client meno capace sappia visualizzare, poi aggiungi i miglioramenti per i client che li supportano. Si chiama spesso progressive enhancement, o graceful degradation se la guardi dal lato opposto.

La base che funziona quasi ovunque

Prima di guardare i singoli client, conviene conoscere le fondamenta su cui contano gli sviluppatori email più esperti:

Tecnica Perché è importante
Layout basato su tabelle Le tabelle sono l'unico modello di layout che capiscono tutti i client, compreso il motore Word di Outlook.
Stili inline Alcuni client e alcuni inoltri eliminano i blocchi <style>, quindi gli stili fondamentali vanno sull'elemento.
Larghezza fissa del contenuto intorno ai 600px Sta nei riquadri di anteprima e nei client desktop, poi si riduce su mobile.
Fallback su font web-safe I font personalizzati si caricano solo in alcuni client; gli altri hanno bisogno di un fallback sensato.
Dimensioni esplicite delle immagini Evitano salti del layout e ridimensionamenti strani, soprattutto in Outlook.
Attributi bgcolor insieme al CSS Danno ai client più vecchi un colore di sfondo anche quando gli sfondi CSS vengono ignorati.

Uno scheletro minimo e robusto è fatto così:

<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>

Tutto il resto di questa guida si basa su questa idea.

Email HTML in Outlook: il motore Word e le sue stranezze

La maggior parte dei grattacapi di compatibilità porta a Outlook per Windows. Le versioni desktop classiche usano Word per il rendering dell'HTML, il che significa che gran parte del CSS moderno lì semplicemente non esiste. Le app Outlook più recenti, tra cui Outlook sul web e il nuovo Outlook per Windows, si comportano molto più come un browser, ma molte organizzazioni usano ancora il client desktop classico, quindi vale la pena progettare anche per lui.

Cosa ignora o rompe Outlook classico

  • max-width non è supportato, quindi i contenitori fluidi possono allargarsi su tutta la finestra.
  • margin è inaffidabile. Le spaziature devono arrivare dal padding delle celle di tabella o da righe spaziatrici.
  • Le immagini di sfondo CSS non vengono mostrate. Outlook classico ha bisogno di VML (Vector Markup Language) o dell'attributo HTML background, più un colore pieno di fallback.
  • border-radius viene ignorato, quindi pulsanti e card arrotondati appaiono con gli angoli squadrati.
  • I gradienti non vengono visualizzati. Senza un colore di fallback, l'area può risultare vuota.
  • colspan e rowspan possono produrre layout imprevedibili. Le tabelle annidate sono più sicure.
  • Altezze fisse combinate con il padding spesso si sommano in modi inattesi, rendendo i blocchi più alti del previsto.
  • I web font non vengono caricati, e indicare un font personalizzato in un font-family inline può far ripiegare Outlook su Times New Roman invece che sul fallback che avevi previsto.

Commenti condizionali: parlare direttamente con Outlook

Outlook capisce dei commenti condizionali speciali che gli altri client trattano come normali commenti HTML. Ti permettono di dare a Outlook un markup tutto suo senza influire su nessun altro. L'uso più comune è un wrapper a larghezza fissa, perché Outlook ignora 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;">
  <!-- contenuto -->
</table>

<!--[if (gte mso 9)|(IE)]>
</td></tr></table>
<![endif]-->

I client moderni usano la tabella con max-width e la riducono su mobile. Outlook vede la tabella fissa da 600px e mantiene intatto il layout.

È comune anche aggiungere nell'<head> un blocco di impostazioni di Office, che aiuta Outlook a gestire le immagini PNG ed evita alcuni problemi di ridimensionamento sui display Windows ad alta risoluzione:

<!--[if gte mso 9]>
<xml>
  <o:OfficeDocumentSettings>
    <o:AllowPNG/>
    <o:PixelsPerInch>96</o:PixelsPerInch>
  </o:OfficeDocumentSettings>
</xml>
<![endif]-->

Immagini di sfondo e VML

Se un banner hero ha del testo sopra una foto di sfondo, di solito è in Outlook classico che va in pezzi. Ci sono tre livelli di supporto a cui puoi puntare:

  1. Fallback con colore pieno. Imposta sempre bgcolor sulla cella, così il testo resta leggibile anche se l'immagine non compare.
  2. L'attributo background. Alcune versioni di Outlook rispettano <td background="...">, che si aggiunge in un attimo.
  3. VML. Per avere il pieno controllo in Outlook classico, racchiudi il contenuto in un rettangolo VML con riempimento a immagine dentro un commento condizionale. Funziona, ma è prolisso, sensibile alle dimensioni esatte e facile da rompere quando il design cambia.

Un fallback a più livelli per una cella con sfondo è fatto così:

<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;">
  <!-- titolo e pulsante -->
</td>

Una regola pratica: se il testo di un banner è essenziale, valuta di tenerlo come testo HTML vivo su un colore pieno invece di affidarti a un'immagine di sfondo. Se il design dipende dall'immagine, testalo apposta in Outlook classico.

Pulsanti bulletproof

I pulsanti fatti con immagini spariscono quando le immagini sono bloccate, e quelli stilizzati con il padding su un link spesso perdono l'area cliccabile in Outlook. Lo schema più sicuro è un pulsante costruito da una cella di tabella con colore di sfondo, altezza esplicita e un line-height uguale all'altezza, così l'etichetta resta centrata in verticale:

<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>

In Outlook gli angoli saranno squadrati, un degrado accettabile. Ovunque altrove il pulsante mantiene la sua forma arrotondata. Per approfondire i bug specifici di Outlook, leggi il nostro articolo sui problemi più comuni delle email HTML in Outlook.

Email HTML in Gmail: sanitizzazione, supporto CSS e taglio

Gmail è molto più capace di Outlook classico, ma ha regole tutte sue. Dato che tantissimi iscritti leggono le email nelle app web e mobile di Gmail, merita un'attenzione dedicata.

Cosa supporta Gmail

  • I blocchi <style> incorporati nell'<head> sono supportati nelle app web e mobile di Gmail, media query comprese. È questo che rende possibili lì le email responsive.
  • I selettori di classe e di ID funzionano, anche se Gmail riscrive i nomi delle classi dietro le quinte.
  • Le proprietà CSS comuni per colori, tipografia, padding, bordi e sfondi in genere non danno problemi.

Dove Gmail fa inciampare

  • Un solo errore può far saltare l'intero blocco di stili. Se al parser di Gmail non piace qualcosa nel tuo tag <style>, può scartarlo tutto. Tieni semplice il CSS incorporato e validalo.
  • Gli account non Gmail nelle app Gmail (per esempio un indirizzo di lavoro o di un altro provider aggiunto all'app Gmail) possono avere un supporto CSS più debole rispetto agli account Gmail nativi. Qui gli stili inline sono la tua rete di sicurezza.
  • Limiti di dimensione. Gmail taglia i messaggi il cui HTML supera circa 102 KB e mostra un link "Visualizza intero messaggio". Tutto ciò che viene dopo il taglio, che spesso include il link di disiscrizione e il pixel di tracciamento, resta nascosto finché chi legge non clicca.
  • Le immagini passano da un proxy. Gmail serve le immagini tramite i propri server, quindi gli URL delle immagini devono essere raggiungibili pubblicamente.

Restare sotto il limite di taglio

Il limite si applica al codice HTML, non alle immagini, che vengono caricate separatamente. Per restarne sotto con margine:

  • Rimuovi il CSS inutilizzato e le dichiarazioni inline ripetute, dove il tuo workflow lo consente.
  • Evita il markup duplicato in profondità, come versioni desktop e mobile separate dello stesso blocco.
  • Tieni d'occhio quello che aggiunge il tuo ESP: i parametri di tracciamento su ogni link e i wrapper dei template aumentano le dimensioni.
  • Controlla la dimensione finale dell'HTML che il tuo ESP invia davvero, non solo quella del file che hai esportato.

Client mobile ed email responsive

Ormai la maggior parte delle email si apre sul telefono, quindi il comportamento responsive fa parte della compatibilità, non è un extra.

Media query con un fallback

L'approccio comune è un layout a larghezza desktop che passa a una sola colonna sotto un breakpoint, di solito appena sotto la larghezza del contenuto:

@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; }
}

Dato che alcuni client ignorano le media query, il layout desktop deve restare leggibile anche quando viene mostrato su uno schermo piccolo. Un layout da 600px che si riduce in proporzione è molto meglio di uno che sborda di lato.

I dettagli mobile che contano

  • Dimensione del testo. Usa almeno 14px per il corpo del testo. iOS Mail può ingrandire di sua iniziativa il testo più piccolo di circa 13px, il che può rompere i layout; l'impostazione -webkit-text-size-adjust aiuta a tenerlo sotto controllo.
  • La formattazione automatica di Apple. Il meta tag x-apple-disable-message-reformatting impedisce ad Apple Mail di ridimensionare i contenuti in modo inatteso.
  • Meta tag viewport. Includilo, così i client mobile scalano l'email correttamente.
  • Aree di tap. I pulsanti devono essere abbastanza grandi da toccare comodamente, e i pulsanti larghi dovrebbero estendersi a tutta larghezza sugli schermi piccoli.
  • Immagini. Usa attributi width con il valore desktop, più max-width: 100% e height: auto per le immagini che devono ridursi.

Se progetti in Figma, la nostra guida all'email design responsive in Figma spiega come impostare i frame perché si traducano senza problemi in layout mobile impilati.

Email in dark mode: tre comportamenti da mettere in conto

La dark mode è la sfida di compatibilità più recente, ed è insidiosa perché i client la gestiscono in modi diversi. A grandi linee si dividono in tre gruppi:

Comportamento Cosa succede Il tuo controllo
Nessuna modifica L'email appare esattamente come progettata. Totale
Inversione parziale Gli sfondi chiari vengono scuriti e il testo scuro schiarito; le aree già scure di solito restano come sono. Limitato
Inversione completa Quasi tutti i colori vengono invertiti, compresi alcuni che avevi reso scuri di proposito. Molto limitato

I client che rispettano la media query prefers-color-scheme, come Apple Mail, ti permettono di fornire una tua palette scura. Altri, tra cui diverse app di Gmail e Outlook, applicano le proprie modifiche ai colori a prescindere da quello che dice il tuo CSS. Il comportamento di un client specifico può cambiare da una versione dell'app all'altra, quindi testare è meglio che memorizzare un elenco.

Attivare il supporto dove è disponibile

Dove un client rispetta i tuoi stili, puoi dichiarare che l'email supporta entrambi gli schemi e fornire degli override per il tema scuro:

<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>

Consideralo un miglioramento. Molti client lo ignoreranno e applicheranno le proprie regolazioni.

Progettare in modo che l'inversione non faccia danni

Dato che non puoi controllare del tutto i client che invertono i colori, la strategia più affidabile è progettare asset che sopravvivano ai cambi di colore:

  • Usa PNG trasparenti per loghi e icone, così non finiscono in un riquadro bianco su uno sfondo scuro.
  • Aggiungi un sottile contorno o alone chiaro ai loghi scuri, così restano visibili quando lo sfondo diventa scuro.
  • Evita, dove puoi, il testo incorporato nelle immagini. Il testo vivo si adatta alla dark mode; il testo dentro un'immagine no.
  • Non usare ovunque il nero e il bianco puri. Valori leggermente diversi spesso sopravvivono meglio all'inversione.
  • Controlla i colori del brand in entrambi i temi. Un colore con un buon contrasto sul bianco può diventare difficile da leggere dopo l'inversione.

Le best practice di email design di FigMail includono questi consigli sugli asset per la dark mode, e vale la pena applicarli in Figma prima di esportare qualsiasi cosa.

Font, immagini e altri dettagli tra client

Web font e fallback

I font personalizzati si caricano in Apple Mail, iOS Mail e in alcuni altri client, ma non in Outlook classico né in diversi client webmail. Un approccio sicuro:

  • Carica il font con un <link> o un @import nell'<head>.
  • Applica il font personalizzato tramite una classe negli stili incorporati.
  • Nel font-family inline lascia solo font web-safe, come Arial, Helvetica, sans-serif o '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>

Così i client che supportano i web font mostrano il carattere del tuo brand, e Outlook ripiega su Arial invece che su Times New Roman.

Immagini

  • Progetta a 1x (600px di larghezza) ed esporta le immagini a 2x, così sono nitide sugli schermi ad alta densità.
  • Imposta sempre width nell'HTML, aggiungi border="0" e usa display: block per eliminare il piccolo spazio che alcuni client aggiungono sotto le immagini.
  • Scrivi un testo alt significativo. Molti client bloccano le immagini di default, e l'alt text è la prima cosa che vedono i lettori.
  • Tieni i messaggi importanti, i prezzi e le call to action in testo vivo, non solo nelle immagini.

Testo del preheader

Il preheader è l'anteprima mostrata dopo l'oggetto. Se non ne imposti uno, i client prendono il primo testo che trovano, che potrebbe essere "Visualizza nel browser". Uno span nascosto per il preheader all'inizio del body, seguito da caratteri di riempimento, mantiene l'anteprima pulita e voluta.

Spaziature senza margini

Dato che i margini sono inaffidabili tra un client e l'altro, le spaziature si creano di solito con il padding sulle celle di tabella o con righe spaziatrici dedicate. I margini negativi, comuni nei layout web, vanno evitati del tutto.

Come testare sui vari client email

Nessuna checklist sostituisce il vedere l'email nei client reali. Una routine di test pratica è questa:

  1. Valida l'HTML. Cerca tag non chiusi ed errori di sintassi CSS, perché un solo errore può far scartare a Gmail i tuoi stili.
  2. Invia vere email di test ad account che controlli: Gmail su web e mobile, Outlook su Windows e sul web, Apple Mail su Mac e iPhone, e qualsiasi client che il tuo pubblico usa molto.
  3. Usa un servizio di anteprima email. Gli strumenti di rendering dedicati generano in un colpo solo screenshot su un gran numero di combinazioni di client, dispositivi e dark mode. Fanno risparmiare tempo, anche se qualche controllo in inbox reali vale comunque la pena.
  4. Testa la dark mode a parte. Passa i tuoi dispositivi alla dark mode e ricontrolla gli stessi invii.
  5. Testa con le immagini disattivate. Assicurati che il messaggio abbia senso anche solo con alt text e testo vivo.
  6. Controlla la dimensione del messaggio che l'ESP invia davvero, per stare alla larga dal taglio di Gmail.
  7. Clicca ogni link e ogni pulsante in almeno un client desktop e uno mobile.

Le analytics del tuo ESP possono mostrarti quali client usano davvero i tuoi iscritti. Concentra i test manuali sui primi della lista e lascia la coda lunga a uno strumento di anteprima.

Una checklist veloce prima dell'invio

  • Layout basato su tabelle con un wrapper a larghezza fissa per Outlook
  • Stili inline su ogni elemento visibile
  • Fallback bgcolor per ogni colore di sfondo, immagine e gradiente
  • Niente colspan, rowspan, margini negativi né overflow
  • Pulsanti bulletproof basati su tabelle
  • Fallback web-safe per i font personalizzati
  • Media query responsive, più un layout che si legge anche senza
  • Loghi e icone adatti alla dark mode
  • Testo del preheader impostato
  • Dimensione dell'HTML ben sotto il limite di taglio

Come FigMail ti aiuta con la compatibilità delle email HTML

Scrivere a mano tutti questi schemi è lento, ed è facile dimenticarne uno quando la scadenza si avvicina. FigMail è un plugin Figma che converte un frame in Auto Layout in un'email HTML basata su tabelle, seguendo regole costruite attorno ai problemi di compatibilità descritti sopra. In base alle regole che segue il generatore, questo include:

  • Struttura basata su tabelle con stili inline e attributi di reset delle tabelle
  • Un wrapper condizionale MSO per la mancanza di supporto a max-width in Outlook, più le impostazioni per Outlook nell'<head>
  • Fallback con gli attributi bgcolor e background per le immagini di sfondo, e un colore medio di fallback per i gradienti
  • Pulsanti basati su tabelle con height e line-height coincidenti
  • Spaziature tramite padding e spacer invece dei margini, senza colspan né rowspan
  • Media query che impilano le colonne e ridimensionano gli elementi su mobile
  • Google Fonts collegati tramite classi, con font di fallback web-safe mantenuti inline per Outlook
  • I meta tag per la riformattazione di Apple e per il viewport, e un preheader nascosto

Alcune cose dipendono comunque dal tuo design. FigMail non sostituisce i test, i layout con sfondi elaborati possono richiedere comunque un controllo manuale in Outlook classico, e i risultati in dark mode dipendono molto da come sono preparati loghi e immagini. Per questo la pagina delle best practice consiglia Auto Layout, larghezza di 600px, font web-safe, asset trasparenti e di evitare immagini di sfondo complesse quando conta il supporto a Outlook.

Prossimi passi

Se progetti email in Figma, il modo più veloce per vedere questi schemi in pratica è esportare uno dei tuoi frame e farlo passare dai tuoi soliti test.

Trasforma il tuo frame Figma in un'email HTML

Installa il plugin FigMail e converti gratis le tue prime email.

Scarica il plugin Figma

Continua a leggere

Pronto a inviare email migliori?

Progetta in Figma, genera con FigMail un HTML pronto per la produzione e invialo dalla piattaforma email che usi già.