Problemas de email HTML no Outlook — Causas e soluções
Guia prático dos bugs de email HTML no Outlook: layouts quebrados, fundos que somem, CSS sem suporte e os fallbacks seguros para Outlook que o FigMail gera.
Quem cria email HTML há tempo suficiente aprende que "no meu navegador está ótimo" quer dizer muito pouco. O Outlook para Windows é o cliente com mais chance de quebrar um layout que funciona em todos os outros, e seus bugs seguem alguns padrões bem claros. Este guia mostra os problemas mais comuns de email HTML no Outlook, explica por que eles acontecem e apresenta as correções que funcionam em produção.
Por que o Outlook renderiza emails de um jeito diferente
A maioria dos clientes de email renderiza HTML com um motor de navegador. O Apple Mail usa WebKit, e o Gmail e os apps mais novos do Outlook rodam em um navegador. O Outlook clássico para Windows (as versões desktop a partir do Outlook 2007) é diferente: ele renderiza emails com o motor de layout do Microsoft Word.
O Word foi feito para diagramar documentos, não páginas web. Por isso, boa parte do CSS moderno é ignorada ou tem suporte apenas parcial. Esse único fato explica quase todos os bugs de email no Outlook que você vai encontrar:
- CSS de layout como
max-width,float, flexbox e grid não é confiável ou é ignorado. - O espaçamento com
marginepaddingse comporta de forma diferente dependendo do elemento em que está. - Imagens de fundo e degradês em CSS não são renderizados na maioria dos elementos.
- CSS decorativo como
border-radiusebox-shadowé descartado. - Web fonts não são carregadas, e uma pilha de fontes mal montada pode cair em Times New Roman.
Também vale saber com qual Outlook você está lidando. "Outlook" engloba vários produtos com renderizações bem diferentes:
| Cliente | Motor de renderização | Comportamento típico |
|---|---|---|
| Outlook 2007–2019, Microsoft 365 desktop (Windows) | Microsoft Word | A maioria dos bugs deste guia |
| Novo Outlook para Windows | Baseado em navegador | Próximo dos webmails modernos |
| Outlook na web (Outlook.com) | Navegador | Bom suporte, com alguma reescrita de CSS |
| Outlook para Mac | WebKit | Parecido com o Apple Mail |
| Outlook para iOS e Android | Nativo/web view | Suporte geralmente bom |
Quando as pessoas falam de problemas de renderização de email no Outlook, quase sempre estão se referindo às versões desktop baseadas no Word. Muitas empresas ainda as usam, então qualquer email que precise parecer profissional tem que levá-las em conta.
Problema 1: o layout quebra ou se estica até a largura total
Sintoma: seu email de 600px se espalha por todo o painel de leitura do Outlook, ou colunas que ficam lado a lado em outros clientes se empilham, se sobrepõem ou ultrapassam o contêiner.
Causa: o Outlook ignora max-width e não suporta float, flexbox nem CSS grid. Um layout construído com elementos div e CSS moderno não tem nada em que o Outlook possa se apoiar.
Correção: construa a estrutura com tabelas e envolva o contêiner principal em uma tabela de largura fixa exclusiva para o Outlook. O Outlook entende comentários condicionais MSO, que os outros clientes tratam como comentários comuns e ignoram.
<!--[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>
<!-- Conteúdo do email -->
</td>
</tr>
</table>
<!--[if (gte mso 9)|(IE)]>
</td></tr></table>
<![endif]-->
Os clientes modernos usam a tabela fluida com max-width. O Outlook vê a "ghost table" fixa de 600px e mantém o email na largura certa.
Linhas com várias colunas
A mesma ideia funciona para colunas. Um padrão responsivo comum usa divs inline-block para que as colunas se empilhem no mobile, mais uma tabela exclusiva para o Outlook que as coloca lado a lado no 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;">
<!-- Coluna 1 -->
</div><!--[if (gte mso 9)|(IE)]></td><td width="300"><![endif]--><div style="display: inline-block; width: 300px; vertical-align: top;">
<!-- Coluna 2 -->
</div>
<!--[if (gte mso 9)|(IE)]>
</td></tr></table>
<![endif]-->
Dois detalhes importam aqui. Mantenha as larguras das colunas na tabela condicional iguais às larguras das divs e evite espaços em branco entre o </div> de fechamento e a próxima coluna, porque elementos inline-block tratam espaço em branco como um vão visível.
Evite colspan e rowspan
Células mescladas são outra fonte de grades quebradas em algumas versões do Outlook. Quando uma seção precisa de uma estrutura de colunas diferente, aninhe uma nova tabela dentro de uma célula em vez de usar colspan ou rowspan.
Problema 2: o espaçamento fica errado, duplicado ou some
Sintoma: os espaços entre as seções ficam diferentes no Outlook, os parágrafos ganham espaço extra ou as margens que você definiu simplesmente não têm efeito.
Causa: o suporte do Outlook a margin é inconsistente, ele adiciona espaçamento padrão próprio às tags p e de títulos e lida mal com padding em elementos div.
Correção: coloque o espaçamento nas células da tabela.
- Use
paddingnos elementostdpara o espaço dentro das seções. É o método de espaçamento mais confiável entre clientes. - Evite
marginemdiv,peimg.margin: 0 autopara centralizar uma tabela é a exceção segura de sempre. - Resete os padrões de todas as tabelas:
cellpadding="0" cellspacing="0" border="0". - Para espaços verticais que não estão dentro de uma célula, use uma linha espaçadora com altura explícita.
<table cellpadding="0" cellspacing="0" border="0" width="100%">
<tr>
<td style="padding: 32px 24px;">
<!-- Conteúdo -->
</td>
</tr>
</table>
Alturas fixas mais padding
Um bug sutil acontece quando você dá a uma célula tanto uma height fixa quanto padding vertical. A altura final é a soma dos dois, e o Outlook pode renderizá-la de forma diferente dos outros clientes. Para blocos com texto ou fundo, defina o tamanho só com padding e deixe a altura automática. Guarde as alturas fixas para os espaçadores.
Problema 3: imagens de fundo e degradês desaparecem
Sintoma: um banner hero com texto sobre uma foto mostra só texto puro sobre branco no Outlook. Botões e seções com degradê viram blocos chapados ou perdem o fundo por completo.
Causa: o motor do Word no Outlook não renderiza background-image em CSS nem degradês em CSS na maioria dos elementos.
Correção: monte os fallbacks em camadas para que todos os clientes recebam algo sensato:
- Defina um
bgcolorsólido na célula. Todos os clientes exibem essa cor. - Adicione o atributo HTML
backgroundnotdcom a URL da imagem. Algumas versões do Outlook o leem. - Adicione o
backgroundem CSS para os clientes modernos. - Para degradês, adicione um
background-colorque combine com o tom geral do degradê, para que o Outlook mostre uma cor sólida próxima em vez de nada.
<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;">
<!-- Título e botão -->
</td>
Garanta que o texto tenha contraste suficiente só com a cor de fallback. Se o texto é branco, o fallback deve ser escuro.
Quando você precisa da imagem no Outlook desktop: VML
O jeito mais confiável de mostrar uma imagem de fundo atrás de texto real no Outlook baseado no Word é o VML (Vector Markup Language), um formato antigo da Microsoft que o Outlook ainda renderiza. Você coloca uma forma VML, como um v:rect com um v:fill do tipo frame, dentro de um comentário condicional MSO, e põe o conteúdo em um 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>
<!-- Título e botão -->
</div>
<!--[if gte mso 9]>
</v:textbox>
</v:rect>
<![endif]-->
O VML exige dimensões fixas em pixels, acrescenta bastante código e é fácil de errar. Use-o onde a imagem de fundo realmente sustenta o layout. Em muitos casos, uma cor sólida de fallback, ou uma imagem achatada com o texto mantido como HTML real logo abaixo, é a escolha mais simples e segura.
Problema 4: cantos arredondados, sombras e botões
Sintoma: botões arredondados ficam retos, sombras somem e botões feitos com padding no link só são clicáveis no próprio texto.
Causa: o Outlook não suporta border-radius nem box-shadow e ignora a maior parte do padding em elementos a inline.
Correção: construa os botões como uma célula de tabela com cor de fundo e coloque o link dentro dela:
<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>
No Outlook, esse botão vai ter cantos retos, o que costuma ser uma troca aceitável. white-space: nowrap mantém o rótulo em uma linha, e display: block no link deixa uma área maior do botão clicável nos clientes que suportam isso. Se cantos arredondados no Outlook forem obrigatórios, um v:roundrect em VML consegue desenhá-los, ao custo de mais código para manter.
Não dependa de sombras para nada importante. Se um card precisa de separação visual, use uma borda ou uma mudança de cor de fundo.
Problema 5: as fontes caem para Times New Roman
Sintoma: seu título em uma sans-serif limpa aparece em uma fonte serifada no Outlook.
Causa: o Outlook baseado no Word não carrega web fonts. Quando encontra uma pilha de fontes que não consegue resolver, principalmente quando o nome da fonte personalizada está no font-family inline, ele pode cair para Times New Roman em vez de usar a próxima fonte da pilha.
Correção:
- Sempre termine a pilha de fontes com uma fonte web-safe, como Arial, Helvetica, Verdana ou Georgia, e uma família genérica.
- Carregue as fontes personalizadas com
@importou uma taglinkpara os clientes que as suportam. - Mantenha no
font-familyinline dos elementos sensíveis ao Outlook apenas fontes web-safe e aplique a fonte personalizada por meio de uma classe no bloco<style>, que o Outlook vai ignorar. - Confira as entrelinhas. O Outlook pode renderizar
line-heightde forma diferente, então defina-a explicitamente em pixels nos elementos de texto.
<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>
O Outlook mostra Arial. Os clientes que carregam web fonts mostram Montserrat.
Problema 6: imagens que borram, esticam ou deixam vãos
Sintoma: as imagens aparecem no tamanho real do arquivo em vez da largura pretendida, imagens Retina ficam enormes ou surgem vãos finos embaixo das imagens.
Causa: o Outlook não respeita de forma confiável width ou max-width em CSS nas imagens, então usa o tamanho real em pixels da imagem, a menos que o atributo HTML width diga outra coisa. Além disso, imagens são elementos inline por padrão, o que deixa espaço abaixo delas para as descendentes do texto.
Correção:
- Sempre defina o atributo
widthem pixels com a largura de exibição pretendida, por exemplowidth="600"para uma imagem Retina de 1200px. - Adicione
style="display: block;"para remover o vão embaixo das imagens. - Adicione
border="0"para que imagens com link não ganhem borda. - Use
max-widthno style para um comportamento fluido nos clientes modernos. - Inclua o bloco de configurações do Office no
<head>para que o Outlook permita imagens PNG e use uma densidade de pixels padrão:
<!--[if gte mso 9]>
<xml>
<o:OfficeDocumentSettings>
<o:AllowPNG/>
<o:PixelsPerInch>96</o:PixelsPerInch>
</o:OfficeDocumentSettings>
</xml>
<![endif]-->
A configuração PixelsPerInch ajuda com um problema bem conhecido em que a escala de exibição do Windows faz o Outlook redimensionar imagens e larguras de forma desigual.
Problema 7: surpresas no dark mode
O dark mode do Outlook, assim como o de outros clientes, pode alterar suas cores. Fundos claros podem ficar escuros e textos escuros podem ficar claros, mas as imagens continuam como estão. O resultado clássico é um logo preto com fundo transparente que desaparece sobre um fundo escuro.
Defesas práticas:
- Use PNGs transparentes para logos e ícones e adicione um contorno claro aos logos escuros para que continuem visíveis sobre fundos escuros.
- Evite texto preto sobre fundo transparente. Coloque o texto em uma célula com cor de fundo explícita.
- Teste suas cores principais nos temas claro e escuro antes de enviar.
Falamos disso com mais profundidade no nosso guia de compatibilidade de email HTML.
Suporte a CSS no Outlook: referência rápida
Esta tabela resume o suporte a CSS do Outlook nas versões desktop baseadas no Word, com a solução de contorno mais comum. O suporte varia de versão para versão, então use-a como ponto de partida e teste.
| Recurso | Outlook desktop (Windows) | Solução de contorno |
|---|---|---|
max-width |
Sem suporte | Ghost table MSO de largura fixa |
float, flexbox, grid |
Sem suporte | Tabelas, inline-block mais tabelas MSO |
margin |
Inconsistente | padding no td, linhas espaçadoras |
padding em div |
Não confiável | padding no td |
background-image (CSS) |
Sem suporte na maioria dos elementos | bgcolor, atributo background, VML |
| Degradês | Sem suporte | Cor sólida de fallback, VML |
border-radius |
Sem suporte | Aceitar cantos retos ou VML |
box-shadow |
Sem suporte | Bordas ou contraste de cores |
| Web fonts | Não carregadas | Pilha de fallback web-safe |
| Media queries | Sem suporte | Layout desktop-first que funcione sem elas |
colspan / rowspan |
Podem quebrar layouts | Tabelas aninhadas |
Checklist de testes para o Outlook
Mesmo um código bem construído precisa ser conferido em um cliente real antes de um envio grande. Uma rotina simples:
- Teste as versões certas. Cubra pelo menos um Outlook desktop baseado no Word, além do Outlook na web e no celular. Use uma instalação real ou um serviço de testes de email que renderize os clientes de verdade.
- Confira a largura. O email deve manter a largura pretendida em um painel de leitura largo.
- Confira todos os fundos. Verifique se as cores de fallback aparecem e se o texto continua legível sem a imagem.
- Confira fontes e entrelinhas. Procure Times New Roman e linhas apertadas ou soltas demais.
- Confira os botões. Garanta que estejam visíveis, legíveis e clicáveis.
- Confira o dark mode. Olhe logos, ícones e qualquer texto sobre fundo transparente.
- Confira com diferentes escalas de exibição. Uma escala do Windows acima de 100% revela bugs de largura e de tamanho de imagens.
Como o FigMail lida com o Outlook
O FigMail é um plugin para Figma que converte um frame do Figma em email HTML baseado em tabelas. Muitas das correções deste guia fazem parte das regras que o gerador com IA segue, então você não precisa adicioná-las na mão:
- Estrutura baseada em tabelas. Os layouts são construídos com tabelas aninhadas, e não com divs ou flexbox, e células mescladas são evitadas.
- Wrappers condicionais MSO. O contêiner principal ganha uma tabela de largura fixa para o Outlook, e as linhas com várias colunas usam tabelas condicionais para que as colunas fiquem lado a lado no Outlook desktop e se empilhem no mobile.
- Sem margens. O espaçamento é feito com padding nas células da tabela e com elementos espaçadores.
- Fallbacks de fundo. As cores de fundo são definidas com
bgcolor, as imagens de fundo recebem o atributo HTMLbackgroundjunto com o CSS, e os degradês ganham uma cor sólida de fallback compatível. - Configurações do Office no head. O bloco com
AllowPNGePixelsPerInché incluído. - Fallbacks de fontes. Você pode usar Google Fonts, e o FigMail monta pilhas de fallback web-safe para que o Outlook não caia em uma fonte serifada padrão.
Duas ressalvas sinceras. Primeiro, o resultado do FigMail segue a graceful degradation: cantos arredondados e sombras vão ficar retos ou ausentes no Outlook desktop, como descrito acima. Segundo, efeitos de fundo complexos atrás de texto real são o caso mais difícil para o Outlook em qualquer fluxo, então confira essas seções em um Outlook de verdade antes de enviar. A pré-visualização do FigMail permite alternar entre as visualizações desktop, mobile e dark mode simulado e comparar o resultado com o seu layout no Figma, mas ela não é um renderizador do Outlook.
O resultado também melhora quando o próprio layout é pensado para email. Use Auto Layout em vez de posicionamento absoluto, mantenha a largura em torno de 600px, evite camadas sobrepostas e espaçamento negativo e construa os botões com Auto Layout, e não com um retângulo com texto por cima. Nossa página de boas práticas reúne tudo isso em um só lugar, e como criar emails HTML no Figma detalha o lado do design.
Próximos passos
Os bugs do Outlook são previsíveis quando você sabe que eles vêm do motor do Word: construa com tabelas, mantenha o espaçamento nas células, dê um fallback a cada fundo, use pilhas de fontes web-safe e teste em um cliente real.
Se você cria seus emails no Figma, pode instalar o plugin FigMail e testar em um dos seus próprios frames. O plano gratuito inclui 3 gerações por mês, e os planos pagos estão na página de preços. Para entender o que acontece entre o seu frame e o HTML final, leia como funciona ou navegue pela documentação para conhecer as opções de pré-visualização, tradução e exportação.
Transforme seu frame do Figma em email HTML
Instale o plugin FigMail e converta seus primeiros emails de graça.
Baixe o plugin para Figma