Documentazione.
FigMail colma il divario tra design e sviluppo delle email. Legge la struttura in Auto Layout del tuo frame Figma e genera un HTML basato su tabelle, costruito secondo le regole dei client email: stili inline, fallback per Outlook e colonne che si impilano su mobile.
Funzionalità principali
- ✓ Da Auto Layout a tabelle HTML
- ✓ Supporto per immagini Retina (@2x)
- ✓ Fallback per Outlook (commenti condizionali MSO)
- ✓ Colonne che si impilano su mobile
Installazione
Per installare FigMail direttamente da Figma:
- Apri Figma e vai alla scheda Community, oppure premi
Shift + Iper aprire Resources. - Cerca "FigMail".
- Clicca Run per iniziare subito, oppure Save per aggiungerlo alla lista dei tuoi plugin.
Nota: FigMail legge i livelli del frame che selezioni per costruire l'email. Il tuo accesso e le tue preferenze restano nello storage locale dei plugin di Figma.
Guida per designer
Da designer, non dovresti aspettare gli sviluppatori né imparare le tabelle HTML. Con FigMail definisci la tua email (spaziature, tipografia, immagini e link) direttamente in Figma.
Export diretto
Passa dal design all'HTML senza attese di handoff né colli di bottiglia lato sviluppo.
Controllo del layout
Le tue impostazioni di Auto Layout diventano strutture di tabelle HTML.
Gestione delle immagini
Le immagini vengono esportate a 2x, compresse e ospitate per te, oppure puoi scaricarle in uno ZIP e ospitarle tu.
Link e URL
Puoi trasformare qualsiasi livello (frame, gruppo, rettangolo, immagine) in un link cliccabile senza aggiungere un livello di testo separato.
Aggiungi l'URL al nome del livello. FigMail riconosce il pattern https:// e racchiude l'elemento in un link.
Nomi dei livelli intelligenti
I nomi dei livelli vengono inviati all'AI insieme al layout, quindi puoi aggiungere brevi istruzioni tra parentesi. Non servono parole chiave speciali: descrivi semplicemente quello che vuoi. L'AI tiene conto di questi suggerimenti, ma restano suggerimenti, non regole garantite.
Chiede all'AI di tenere queste colonne affiancate su mobile invece di impilarle.
Chiede al generatore di centrare l'immagine di sfondo di questo frame.
Chiede una griglia a 2 colonne su mobile invece della colonna singola predefinita.
Icone complesse e vettori
A volte un'icona è fatta di molti tracciati vettoriali. Per esportarla come un'unica immagine nitida:
- 1Seleziona il gruppo o il frame che contiene l'icona.
- 2Nella barra laterale destra, clicca + accanto a Export.
- 3FigMail esporterà l'intero gruppo come un'unica immagine, identica al design.
Frame o gruppi
Per la struttura del layout preferisci sempre i frame. I gruppi composti solo da vettori semplici vengono appiattiti in un'unica immagine. I frame con Auto Layout diventano tabelle HTML.
Livelli nascosti
I livelli con la visibilità disattivata (icona dell'occhio) vengono ignorati. Usali per tenere bozze o testi alternativi nel file senza influire sull'export.
Basi del design
Tipografia e font web-safe
I font personalizzati (come Inter o SF Pro) spesso ripiegano su Times New Roman in Outlook e in alcuni altri client.
- ✓FigMail aggiunge automaticamente fallback web-safe (Arial/Helvetica).
- •Usa i font di sistema per il corpo del testo, così resta leggibile ovunque.
Pulsanti con l'Auto Layout
Non costruire i pulsanti come gruppi "Rettangolo + Testo".
- ✓Applica l'Auto Layout (Shift+A) al livello di testo.
- ✓Aggiungi il riempimento e il raggio degli angoli direttamente al frame: è il modo per ottenere il codice più pulito. Tieni presente che in Outlook gli angoli dei pulsanti appaiono squadrati.
Ombre e sfocature (effetti)
Il CSS box-shadow non è supportato in Outlook.
- !Evita le ombre sugli elementi nativi come i pulsanti.
- •Se un'ombra è indispensabile, esporta l'intero elemento come immagine.
Dark mode e trasparenza
La tua email potrebbe essere visualizzata in dark mode.
- ✓Usa PNG trasparenti per loghi e icone.
- ✕Evita il testo nero su sfondi trasparenti (in dark mode scompare).
Strategia per il layout mobile
Ragiona per colonne. Di default FigMail impila le colonne in verticale su mobile.
- •Immagina come i tuoi blocchi si impileranno uno sotto l'altro.
Dimensioni ottimali
Mantieni la larghezza del design tra 600px e 640px.
- ✓È la larghezza standard più diffusa, adatta ai client email desktop e mobile.
Usare FigMail
Quando il design è pronto, generare il codice è semplice:
Funzionalità AI
Oltre a convertire il design così com'è, durante la generazione FigMail può fare altre due cose: tradurre l'email e migliorarne il layout.
Traduzione
Traduci tutti i testi della tua email in un'altra lingua, mantenendo la struttura e la formattazione del design originale.
Come funziona
- 1Clicca il pulsante Translate nel plugin.
- 2Scegli la lingua di destinazione dall'elenco.
- 3Clicca Generate HTML: l'AI traduce i testi mentre costruisce l'email.
Lingue supportate
Non trovi la tua lingua? Contattaci e valuteremo se aggiungerla.
Suggerimento: La lingua selezionata compare come badge accanto al pulsante Translate. Clicca l'icona X per rimuoverla. La traduzione automatica può sbagliare, quindi fai rivedere le email importanti a un madrelingua.
Miglioramento del layout
Lascia che l'AI perfezioni e rifinisca il tuo design oltre il layout esatto di Figma, mantenendo la struttura dei contenuti e l'intento originale.
Come funziona
Clicca il pulsante Improve Layout (icona del razzo) per attivare o disattivare questa opzione. Quando è attiva, l'AI può:
Quando usarlo: Usalo quando il tuo design è una bozza o quando vuoi che l'AI dia alla tua email un tocco più professionale.
Quando evitarlo: Se ti serve un HTML il più fedele possibile al design Figma, lascia questa opzione disattivata.
Combinare le funzionalità
Puoi usare Translate e Improve Layout insieme. Per esempio, traduci la tua email in spagnolo e lascia che l'AI rifinisca il design, tutto in un'unica generazione.
Anteprima del risultato
Al termine della generazione vedrai la schermata dei risultati, dove puoi visualizzare in anteprima, confrontare ed esportare l'HTML della tua email.
Modalità di anteprima
Vista desktop
Visualizza l'email a 800px di larghezza, un viewport desktop tipico.
Vista mobile
Verifica il comportamento responsive a 425px di larghezza: guarda come si impilano le colonne e come scorre il testo.
Light mode
L'anteprima chiara standard: come la vedrà la maggior parte dei destinatari.
Dark mode
Un'anteprima approssimativa della dark mode: un'inversione dei colori in stile Gmail che mostra se testi e immagini restano leggibili. Ogni client email applica le proprie regole per la dark mode, quindi i risultati possono variare.
Confronto visivo
Sotto l'anteprima, un confronto affiancato ti permette di verificare l'HTML generato rispetto al design Figma originale.
Azioni di export
In fondo alla schermata dei risultati trovi quattro azioni:
Copia codice
Copia l'HTML completo negli appunti. Incollalo direttamente nell'editor di codice del tuo ESP.
Scarica HTML
Scarica un unico file .html. Le immagini sono collegate dalla CDN di FigMail.
Scarica archivio
Scarica un file ZIP con l'HTML e tutte le immagini. Usalo se vuoi ospitare le immagini sul tuo server.
Apri nell'editor di Blocks
Apre l'email in Blocks, un editor visuale per email, così puoi continuare a modificarla lì.
Suggerimento: Premi ESC per tornare al pannello Cronologia e vedere le altre generazioni.
Cronologia delle generazioni
FigMail tiene una cronologia delle tue generazioni, così puoi tornare a un'email precedente ed esportarla di nuovo.
Aprire la cronologia
Clicca l'icona dell'orologio nell'intestazione del plugin per aprire il pannello Cronologia. Scorre da destra e mostra le tue generazioni passate.
Miniature di anteprima
Ogni voce mostra una miniatura del design Figma originale, così la riconosci al volo.
Nomi dei frame
Viene mostrato il nome del frame Figma, per aiutarti a trovare un'email specifica.
Data e ora
Vedi quando è stata creata ogni generazione: per le voci di oggi compare solo l'ora, per quelle più vecchie la data completa.
Scorrimento infinito
Scorri verso il basso per vederne altre: le generazioni più vecchie si caricano automaticamente quando arrivi in fondo.
Indicatori di stato
Ogni generazione mostra un badge con il suo stato attuale:
Riprendere le generazioni in corso
Se chiudi il plugin mentre una generazione è in corso, niente paura. Riapri il plugin e clicca la voce in elaborazione nella Cronologia per continuare a seguirne l'avanzamento. La generazione prosegue sul server, che il plugin sia aperto o no.
Codice ed export
FigMail genera un HTML pulito e ben strutturato, che segue le best practice dello sviluppo email. Il codice è pensato per essere leggibile, facile da mantenere ed estendere.
Struttura chiara
Tabelle annidate in modo logico, con una gerarchia chiara.
Stili inline
Gli stili principali sono su ogni elemento, così l'email regge anche nei client che rimuovono il CSS.
A prova di Outlook
Commenti condizionali MSO, ghost table e fallback bgcolor per Outlook.
Pronto per il mobile
Le media query impilano le colonne sugli schermi piccoli.
Struttura del codice
Layout basato su tabelle
Tabelle annidate per la compatibilità con Outlook
CSS inline
Stili principali applicati direttamente agli elementi
Fallback per Outlook
Commenti condizionali, ghost table e colori pieni di fallback per i gradienti
Media query
Breakpoint responsive negli stili incorporati
Integrazione con gli ESP
L'HTML generato è HTML standard per email, quindi puoi usarlo con qualsiasi email service provider. Ecco come:
Mailchimp
Incollalo nell'editor di codice in "Edit with HTML"
Klaviyo
Importalo da Templates → Create from HTML
SendGrid
Usalo nei Dynamic Templates o nelle Marketing Campaigns
Qualsiasi altro ESP
Incolla o importa l'HTML dove è accettato codice personalizzato
Personalizzazione
Merge tag
Sostituisci il testo segnaposto con la sintassi di personalizzazione del tuo ESP:
{{first_name}}*|FNAME|*${contact.firstName}Pixel di tracciamento
Aggiungi il tuo pixel di analytics prima del tag di chiusura </body>. La maggior parte degli ESP lo aggiunge automaticamente.
Logica condizionale
Racchiudi le sezioni nella sintassi condizionale del tuo ESP per mostrare o nascondere contenuti in base ai dati degli iscritti.
Cosa contiene l'export
| Elemento | Descrizione |
|---|---|
| Immagini | Esportate a 2x e ospitate sulla CDN di FigMail. Scarica l'archivio se vuoi ospitarle tu. |
| Web font | I Google Fonts sono collegati nell'head del documento, con fallback web-safe per i client che li ignorano, come Outlook. |
| Preheader | Testo di anteprima nascosto che le inbox mostrano accanto all'oggetto. |
Risoluzione dei problemi
Perché il risultato può essere diverso dal design?
I client email supportano molto meno CSS dei browser. Alcuni effetti di Figma (ombre, sfocature, metodi di fusione) non si possono riprodurre 1:1 nell'HTML di un'email.
Inoltre, FigMail usa un motore AI per generare il codice. Le differenze possono dipendere da:
- Struttura del layout complessa: frame annidati in profondità o posizionamenti ambigui.
- Indicazioni di design: non sono state seguite le Best practice.
- Interpretazione dell'AI: errori di elaborazione occasionali o "allucinazioni" del modello.
Se incontri problemi importanti, prova a semplificare la struttura del layout (usa l'Auto Layout) o rileggi la Guida per designer qui sopra.
Le immagini non compaiono?
Assicurati che le immagini siano dentro il frame selezionato. Se le ospiti tu, verifica che i loro URL siano accessibili pubblicamente.
Il layout si rompe in Outlook?
Outlook per Windows usa il motore di rendering di Word. Evita livelli sovrapposti e margini negativi e resta su un Auto Layout semplice. In Outlook gli angoli arrotondati dei pulsanti appaiono squadrati.
Il testo ha un aspetto diverso?
I client email spesso sovrascrivono gli stili dei font, e molti ignorano i web font. FigMail aggiunge sempre un fallback web-safe (come Arial o Helvetica), così il testo resta leggibile quando un font personalizzato non si carica.