Todos os artigos
Técnico 22 de novembro de 2026 12 min de leitura

Compatibilidade de email HTML: Outlook, Gmail e dark mode

Guia de compatibilidade de email HTML para devs: as manias do Outlook e o VML, o suporte a CSS do Gmail, dark mode e como testar antes de enviar.

Um email que fica perfeito no seu navegador pode chegar quebrado na caixa de entrada do assinante, porque cada cliente de email renderiza HTML do seu próprio jeito. Este guia mostra os clientes que mais dão trabalho, por que eles se comportam assim e os padrões práticos que mantêm uma campanha legível em qualquer lugar. Ele foi escrito para profissionais de marketing, designers e desenvolvedores que querem menos surpresas depois de apertar o botão de enviar.

Por que a compatibilidade de email HTML ainda é difícil

Os navegadores convergiram para padrões comuns há anos. Os clientes de email, não. Um email é renderizado pelo motor que o cliente do destinatário usa, e esses motores são muito diferentes entre si:

  • O Outlook para Windows (versões desktop clássicas) renderiza HTML com o motor de layout do Microsoft Word, e não com um motor de navegador.
  • O Gmail passa sua marcação por um sanitizador próprio, reescreve os nomes de classes e remove o CSS que não permite.
  • O Apple Mail e o Mail do iOS usam WebKit e suportam a maior parte do CSS moderno.
  • Webmails e apps mobile adicionam, cada um, seus próprios wrappers, estilos e comportamento de dark mode por cima do seu código.

Você não controla qual cliente o assinante usa, então a compatibilidade entre clientes de email se resume a um princípio: escreva uma marcação que o cliente menos capaz consiga renderizar e depois adicione melhorias para os clientes que as suportam. Isso costuma ser chamado de progressive enhancement, ou graceful degradation quando visto pelo outro lado.

A base que funciona em quase todo lugar

Antes de olhar cada cliente, vale conhecer a base em que os desenvolvedores de email experientes confiam:

Técnica Por que importa
Layout baseado em tabelas Tabelas são o único modelo de layout que todos os clientes entendem, incluindo o motor do Word no Outlook.
Estilos inline Alguns clientes e encaminhamentos descartam blocos <style>, então os estilos essenciais devem ficar no próprio elemento.
Largura fixa de conteúdo em torno de 600px Cabe nos painéis de pré-visualização e nos clientes desktop e depois reduz no mobile.
Fallbacks de fontes web-safe Fontes personalizadas só carregam em alguns clientes; os demais precisam de um fallback sensato.
Dimensões explícitas nas imagens Evita saltos de layout e redimensionamentos estranhos, principalmente no Outlook.
Atributos bgcolor junto com o CSS Garante uma cor de fundo nos clientes mais antigos mesmo quando os fundos em CSS são ignorados.

Uma estrutura mínima e robusta fica assim:

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

Todo o resto deste guia se apoia nessa ideia.

Email HTML no Outlook: o motor do Word e suas manias

A maior parte das dores de cabeça com compatibilidade vem do Outlook para Windows. As versões desktop clássicas usam o Word para renderizar HTML, o que significa que boa parte do CSS moderno simplesmente não existe por lá. Os apps mais novos do Outlook, incluindo o Outlook na web e o novo Outlook para Windows, se comportam muito mais como um navegador, mas muitas empresas ainda usam o cliente desktop clássico, então vale a pena criar pensando nele.

O que o Outlook clássico ignora ou quebra

  • max-width não é suportado, então contêineres fluidos podem se esticar pela janela inteira.
  • margin não é confiável. O espaçamento deve vir de padding nas células da tabela ou de linhas espaçadoras.
  • Imagens de fundo em CSS não são exibidas. O Outlook clássico precisa de VML (Vector Markup Language) ou do atributo HTML background, além de uma cor sólida de fallback.
  • border-radius é ignorado, então botões e cards arredondados aparecem com cantos retos.
  • Degradês não são renderizados. Sem uma cor de fallback, a área pode aparecer em branco.
  • colspan e rowspan podem gerar layouts imprevisíveis. Tabelas aninhadas são mais seguras.
  • Alturas fixas combinadas com padding costumam se somar de formas inesperadas, deixando os blocos mais altos do que o previsto.
  • Web fonts não são carregadas, e indicar uma fonte personalizada em um font-family inline pode fazer o Outlook usar Times New Roman em vez do fallback que você queria.

Comentários condicionais: falando direto com o Outlook

O Outlook entende comentários condicionais especiais, que os outros clientes tratam como comentários HTML comuns. Eles permitem entregar ao Outlook uma marcação própria sem afetar mais ninguém. O uso mais comum é um wrapper de largura fixa, porque o 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;">
  <!-- conteúdo -->
</table>

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

Os clientes modernos usam a tabela com max-width e a reduzem no mobile. O Outlook vê a tabela fixa de 600px e mantém o layout intacto.

Também é comum adicionar um bloco de configurações do Office no <head>, que ajuda o Outlook a lidar com imagens PNG e evita alguns problemas de escala em telas Windows de alta resolução:

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

Imagens de fundo e VML

Se um banner hero tem texto sobre uma foto de fundo, é no Outlook clássico que ele costuma desmoronar. Existem três níveis de suporte que você pode buscar:

  1. Cor sólida de fallback. Sempre defina bgcolor na célula para que o texto continue legível mesmo que nenhuma imagem apareça.
  2. O atributo background. Algumas versões do Outlook respeitam <td background="...">, que é rápido de adicionar.
  3. VML. Para ter controle total no Outlook clássico, envolva o conteúdo em um retângulo VML com preenchimento de imagem dentro de um comentário condicional. Funciona, mas é verboso, sensível às dimensões exatas e fácil de quebrar quando o layout muda.

Um fallback em camadas para uma célula com fundo fica assim:

<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;">
  <!-- título e botão -->
</td>

Uma regra prática: se o texto de um banner é essencial, considere mantê-lo como texto HTML real sobre uma cor sólida em vez de depender de uma imagem de fundo. Se o layout depende da imagem, teste especificamente no Outlook clássico.

Botões bulletproof

Botões feitos com imagens desaparecem quando as imagens são bloqueadas, e botões estilizados com padding em um link costumam perder a área clicável no Outlook. O padrão mais seguro é um botão construído a partir de uma célula de tabela com cor de fundo, altura explícita e um line-height igual à altura, para que o rótulo fique centralizado na vertical:

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

No Outlook, os cantos vão ficar retos, o que é uma degradação aceitável. Em todos os outros clientes, o botão mantém o formato arredondado. Para se aprofundar nos bugs específicos do Outlook, veja nosso artigo sobre problemas comuns de email HTML no Outlook.

Email HTML no Gmail: sanitização, suporte a CSS e corte de mensagens

O Gmail é muito mais capaz que o Outlook clássico, mas tem regras próprias. Como muitos assinantes leem emails nos apps web e mobile do Gmail, ele merece atenção especial.

O que o Gmail suporta

  • Blocos <style> incorporados no <head> são suportados nos apps web e mobile do próprio Gmail, incluindo media queries. É isso que torna o email responsivo possível por lá.
  • Seletores de classe e ID funcionam, embora o Gmail reescreva os nomes das classes nos bastidores.
  • Propriedades CSS comuns de cor, tipografia, padding, bordas e fundos geralmente funcionam bem.

Onde o Gmail pega as pessoas de surpresa

  • Um erro pode derrubar o bloco de estilos inteiro. Se o parser do Gmail não gostar de algo na sua tag <style>, ele pode descartar tudo. Mantenha o CSS incorporado simples e valide-o.
  • Contas que não são do Gmail nos apps do Gmail (por exemplo, um endereço do trabalho ou de outro provedor adicionado ao app do Gmail) podem ter suporte a CSS mais fraco do que as contas nativas do Gmail. Os estilos inline são a sua rede de segurança aqui.
  • Limites de tamanho. O Gmail corta mensagens cujo HTML passa de cerca de 102 KB e mostra um link "Ver mensagem inteira". Tudo o que vem depois do corte, o que muitas vezes inclui o link de descadastro e o pixel de rastreamento, fica escondido até o leitor clicar.
  • As imagens passam por proxy. O Gmail serve as imagens pelos próprios servidores, então as URLs das imagens precisam ser acessíveis publicamente.

Como manter os emails abaixo do limite de corte

O limite vale para o código HTML, e não para as imagens, que são carregadas separadamente. Para ficar com folga abaixo dele:

  • Remova CSS não utilizado e declarações inline repetidas sempre que o seu fluxo permitir.
  • Evite marcação muito duplicada, como versões separadas para desktop e mobile do mesmo bloco.
  • Fique de olho no que o seu ESP adiciona: parâmetros de rastreamento em cada link e wrappers de template aumentam o tamanho.
  • Confira o tamanho final do HTML que o seu ESP realmente envia, e não só do arquivo que você exportou.

Clientes mobile e email responsivo

A maioria dos emails hoje é aberta no celular, então o comportamento responsivo faz parte da compatibilidade, e não é um bônus.

Media queries com fallback

A abordagem mais comum é um layout com largura de desktop que muda para uma coluna única abaixo de um breakpoint, geralmente um pouco menor que a largura do conteúdo:

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

Como alguns clientes ignoram media queries, o layout desktop precisa continuar legível quando exibido em uma tela pequena. Um layout de 600px que reduz proporcionalmente é muito melhor do que um que vaza para os lados.

Detalhes do mobile que fazem diferença

  • Tamanho do texto. Use pelo menos 14px no corpo do texto. O Mail do iOS pode aumentar por conta própria textos menores que cerca de 13px, o que pode quebrar layouts, e a configuração -webkit-text-size-adjust ajuda a controlar isso.
  • Formatação automática da Apple. A meta tag x-apple-disable-message-reformatting impede que o Apple Mail redimensione seu conteúdo de forma inesperada.
  • Meta tag viewport. Inclua-a para que os clientes mobile dimensionem o email corretamente.
  • Áreas de toque. Os botões devem ser grandes o suficiente para um toque confortável, e botões largos devem se expandir até a largura total em telas pequenas.
  • Imagens. Use atributos width com o valor de desktop, além do comportamento max-width: 100% e height: auto para as imagens que devem encolher.

Se você cria no Figma, nosso guia de design de email responsivo no Figma mostra como configurar os frames para que eles se traduzam bem em layouts mobile empilhados.

Dark mode em email: três comportamentos para os quais você precisa se planejar

O dark mode é o desafio de compatibilidade mais recente, e é complicado porque cada cliente lida com ele de um jeito. De modo geral, eles se dividem em três grupos:

Comportamento O que acontece Seu controle
Sem alteração O email é renderizado exatamente como foi criado. Total
Inversão parcial Fundos claros são escurecidos e textos escuros são clareados; áreas que já são escuras geralmente ficam como estão. Limitado
Inversão total A maioria das cores é invertida, incluindo algumas que você escureceu de propósito. Muito limitado

Os clientes que respeitam a media query prefers-color-scheme, como o Apple Mail, permitem que você forneça sua própria paleta escura. Outros, incluindo vários apps do Gmail e do Outlook, aplicam suas próprias mudanças de cor, independentemente do que o seu CSS diz. O comportamento de cada cliente pode mudar entre versões do app, então testar vale mais do que decorar uma lista.

Como ativar onde há suporte

Quando um cliente respeita seus estilos, você pode declarar que o email suporta os dois esquemas e fornecer substituições para o modo escuro:

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

Trate isso como uma melhoria. Muitos clientes vão ignorar e aplicar os próprios ajustes.

Como criar para que a inversão não atrapalhe

Como você não controla totalmente os clientes que invertem as cores, a estratégia mais confiável é criar assets que sobrevivam às mudanças de cor:

  • Use PNGs transparentes para logos e ícones para que eles não fiquem dentro de uma caixa branca sobre um fundo escuro.
  • Adicione um contorno ou brilho claro e fino aos logos escuros para que continuem visíveis quando o fundo escurecer.
  • Evite texto embutido em imagens sempre que possível. Texto real se adapta ao dark mode; texto em imagem, não.
  • Não use preto puro e branco puro em tudo. Valores levemente diferentes costumam sobreviver melhor à inversão.
  • Confira as cores da marca nos dois temas. Uma cor que passa no teste de contraste sobre o branco pode ficar difícil de ler depois da inversão.

As boas práticas de design de email do FigMail incluem essas dicas de assets para dark mode, e vale a pena aplicá-las no Figma antes de exportar qualquer coisa.

Fontes, imagens e outros detalhes entre clientes

Web fonts e fallbacks

Fontes personalizadas carregam no Apple Mail, no Mail do iOS e em alguns outros clientes, mas não no Outlook clássico nem em vários webmails. Uma abordagem segura:

  • Carregue a fonte com <link> ou @import no <head>.
  • Aplique a fonte personalizada por meio de uma classe nos estilos incorporados.
  • Mantenha apenas fontes web-safe no font-family inline, como Arial, Helvetica, sans-serif ou '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>

Assim, os clientes que suportam web fonts recebem a tipografia da sua marca, e o Outlook usa Arial como fallback em vez de Times New Roman.

Imagens

  • Crie em 1x (600px de largura) e exporte as imagens em 2x para que fiquem nítidas em telas de alta densidade.
  • Sempre defina width no HTML, adicione border="0" e use display: block para remover o pequeno espaço que alguns clientes colocam abaixo das imagens.
  • Escreva um texto alt significativo. Muitos clientes bloqueiam imagens por padrão, e o alt text é a primeira coisa que os leitores veem.
  • Mantenha mensagens importantes, preços e chamadas para ação em texto real, e não só em imagens.

Texto do preheader

O preheader é o trecho de prévia exibido depois da linha de assunto. Se você não definir um, os clientes pegam o primeiro texto que encontram, que pode ser "View in browser". Um span de preheader oculto no topo do body, seguido de caracteres de preenchimento, mantém a prévia limpa e intencional.

Espaçamento sem margens

Como as margens não são confiáveis entre clientes, o espaçamento geralmente é criado com padding nas células da tabela ou com linhas espaçadoras dedicadas. Margens negativas, comuns em layouts web, devem ser evitadas por completo.

Como testar em diferentes clientes de email

Nenhum checklist substitui ver o email em clientes reais. Uma rotina de testes prática fica assim:

  1. Valide o HTML. Procure tags não fechadas e erros de sintaxe no CSS, já que um único erro pode fazer o Gmail descartar seus estilos.
  2. Envie emails de teste reais para contas que você controla: Gmail na web e no celular, Outlook no Windows e na web, Apple Mail no Mac e no iPhone, e qualquer cliente que o seu público use bastante.
  3. Use um serviço de pré-visualização de email. Ferramentas dedicadas de renderização geram capturas de tela em um grande número de combinações de cliente, dispositivo e dark mode de uma só vez. Elas economizam tempo, embora algumas conferências em caixas de entrada reais ainda valham a pena.
  4. Teste o dark mode separadamente. Mude seus dispositivos para o dark mode e revise os mesmos envios de novo.
  5. Teste com as imagens desativadas. Confirme que a mensagem ainda faz sentido só com o alt text e o texto real.
  6. Confira o tamanho da mensagem que o ESP realmente envia, para não esbarrar no corte do Gmail.
  7. Clique em todos os links e botões em pelo menos um cliente desktop e um mobile.

O analytics do seu ESP pode mostrar quais clientes seus assinantes realmente usam. Concentre os testes manuais nos principais e deixe uma ferramenta de pré-visualização cobrir o restante.

Checklist rápido antes do envio

  • Layout baseado em tabelas com um wrapper de largura fixa para o Outlook
  • Estilos inline em todos os elementos visíveis
  • Fallbacks com bgcolor para todas as cores de fundo, imagens e degradês
  • Nada de colspan, rowspan, margens negativas ou overflow
  • Botões bulletproof baseados em tabelas
  • Fallbacks web-safe para as fontes personalizadas
  • Media queries responsivas, além de um layout que continue legível sem elas
  • Logos e ícones preparados para o dark mode
  • Texto do preheader definido
  • Tamanho do HTML com folga abaixo do limite de corte

Como o FigMail ajuda na compatibilidade de email HTML

Codificar todos esses padrões na mão é lento, e é fácil esquecer algum quando o prazo está apertado. O FigMail é um plugin para Figma que converte um frame com Auto Layout em email HTML baseado em tabelas, seguindo regras criadas em torno dos problemas de compatibilidade descritos acima. De acordo com as regras que o gerador segue, isso inclui:

  • Estrutura baseada em tabelas, com estilos inline e atributos de tabela resetados
  • Um wrapper condicional MSO para a falta de suporte a max-width no Outlook, além das configurações do Outlook no <head>
  • Fallbacks com os atributos bgcolor e background para imagens de fundo e uma cor média como fallback para degradês
  • Botões baseados em tabelas, com height e line-height iguais
  • Espaçamento com padding e espaçadores em vez de margens, sem colspan nem rowspan
  • Media queries que empilham as colunas e redimensionam elementos no mobile
  • Google Fonts conectadas por classes, com fontes web-safe de fallback mantidas inline para o Outlook
  • Meta tags de reformatação da Apple e de viewport, além de um preheader oculto

Algumas coisas ainda dependem do seu layout. O FigMail não substitui os testes, layouts com fundos elaborados ainda podem precisar de uma conferência manual no Outlook clássico, e os resultados no dark mode dependem muito de como seus logos e imagens foram preparados. É por isso que a página de boas práticas recomenda Auto Layout, largura de 600px, fontes web-safe, assets transparentes e evitar imagens de fundo complexas quando o suporte ao Outlook importa.

Próximos passos

Se você cria emails no Figma, o jeito mais rápido de ver esses padrões na prática é exportar um dos seus próprios frames e passá-lo pelos seus testes de sempre.

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

Continue lendo

Pronto para enviar emails melhores?

Crie no Figma, gere HTML pronto para produção com o FigMail e envie pela plataforma de email que você já usa.