Recursos

Modo Escuro em E-mail: O Que Realmente Quebra e Como Projetar em Torno Disso

O suporte a modo escuro em e-mail se divide em três: clientes que respeitam @media (prefers-color-scheme) exatamente como escrito, clientes que reescrevem a regra silenciosamente para algo que nunca dá match, e todos os demais, que deixam as decisões de cor para suas próprias heurísticas de inversão automática. Projetar apenas para o primeiro grupo é projetar para menos da metade da caixa de entrada.

Publicado em 23 de agosto de 2026 · Atualizado em 14 de novembro de 2026 · Pela equipe MailInApp

O suporte a modo escuro em e-mail se divide em três, e apenas um deles é o CSS para o qual a maioria dos remetentes projeta. Alguns clientes respeitam @media (prefers-color-scheme: dark) exatamente como está escrito. Outros a reescrevem em uma sintaxe que nunca dá match e recolorem o e-mail por conta própria. Um terceiro grupo mal reconhece a meta tag color-scheme, mais recente. Projetar apenas para o primeiro grupo é projetar para menos da metade da caixa de entrada, e por isso o MailInApp deixa todo e-mail legível nos três.

Grupo um: clientes que respeitam a media query

Segundo o caniemail.com, @media (prefers-color-scheme: dark) consta como suportada no Gmail (todas as plataformas) e no Apple Mail (macOS 12.4+ e iOS 13.0+). O Outlook fica logo atrás: Windows, macOS, Outlook.com e mobile reconhecem a regra, e o Outlook para macOS e o Outlook.com também acrescentam seus próprios atributos de dados de modo escuro. O Samsung Email (Android 6.1+) também a suporta. Combinado, o painel testado do caniemail.com aponta suporte geral de 41.86%, uma fatia real dos grandes clientes, mas longe de todos eles.

Nos testes do próprio MailInApp em caixas de entrada reais (outubro de 2026), o Gmail não correspondeu a essa lista. A media query foi aplicada no Mail no iPhone e no iPad, no iCloud Mail na web, no Outlook.com e nos apps do Outlook para iOS e Android, e o Outlook.com também adicionou seus atributos [data-ogsc] e [data-ogsb]. Nenhum app do Gmail a aplicou: o Gmail na web manteve o e-mail claro, o app do Gmail para Android o recoloriu em parte por conta própria, e o app do Gmail para iOS o inverteu por completo. Para fins de planejamento, trate o Gmail como um cliente que decide o modo escuro por você, junto com o grupo dois. Ainda não medimos o Apple Mail no macOS, o Outlook no Windows ou no macOS, nem o Samsung Email.

Grupo dois: clientes que reescrevem a regra para algo que nunca dá match

Esse grupo produz os e-mails de modo escuro desbotados que a maioria dos remetentes já viu. Yahoo Mail, AOL e Fastmail reescrevem prefers-color-scheme em uma sintaxe inválida (@media ( _filtered_a )) que nunca pode ser verdadeira, o que desliga toda regra dentro dela. O HEY reescreve a regra para @media (false). Nos dois casos, o cliente aplica então a própria inversão automática de cor ao design claro, que é o que deixa logotipos pálidos e texto com pouco contraste, porque nada do que o remetente escreveu orienta o resultado.

Os testes do próprio MailInApp (outubro de 2026) confirmam isso para o Yahoo Mail, que recoloriu o e-mail por conta própria. O Thunderbird se comportou da mesma forma: não aplica nenhuma media query e recolore o e-mail em parte por conta própria.

Grupo três: a meta tag color-scheme, ainda rara

<meta name="color-scheme" content="light dark"> (e sua prima supported-color-schemes) informa a um cliente para quais modos um e-mail foi projetado, para que o cliente possa pular a inversão em vez de adivinhar. É o ajuste mais preciso, mas, segundo o caniemail.com, o suporte combinado é de apenas 9.76%. O Apple Mail (macOS 16+ e iOS 12.4+), versões recentes do Outlook, o Samsung Email 9.1 e o Thunderbird 102.11 constam como compatíveis, e o Gmail respeita apenas o valor "somente claro". A maioria dos outros clientes a ignora.

O que isso significa para o design

Nenhuma regra única cobre os três grupos. A abordagem confiável é o aprimoramento progressivo, o mesmo princípio ao qual chega o guia de modo escuro da Litmus:

  • Projete primeiro um e-mail em modo claro totalmente legível. É a base para a qual todo cliente recorre, incluindo o grupo dois e todos os apps do Gmail.
  • Sobreponha overrides explícitos de prefers-color-scheme para os cerca de 42% de clientes que os aplicam, e não dependa apenas da meta tag.
  • Proteja logotipos e imagens contra a inversão. Um PNG semitransparente sobre branco pode ficar ilegível no grupo dois e nos apps do Gmail. Uma borda ou um fundo sólido atrás do ativo sobrevive à inversão.
  • Defina as cores do texto explicitamente. A inversão automática pode inverter um fundo sem inverter o texto do jeito que o remetente espera.

O que o MailInApp faz a respeito

O estúdio cobre os três grupos sem nenhum trabalho de CSS da sua parte:

  • Configuração de Modo escuro. No painel Tema, Auto recolore o texto neutro e os fundos brancos com cores escuras padrão e mantém as cores da sua marca. Personalizado usa a sua própria paleta escura, com Texto no modo escuro e Fundo no modo escuro por bloco e uma versão escura de qualquer imagem. Desativado não envia estilos de modo escuro. As opções estão em Tema, celulares e modo escuro.
  • Uma prévia que corresponde às caixas de entrada reais. O alternador de modo escuro da prévia Clientes mostra o modo escuro de cada app de e-mail como o medimos, incluindo os apps que recolorem por conta própria.
  • Avisos de pré-voo. A Verificação de Pré-Voo sinaliza PNGs transparentes sem fundo e texto escuro sem contêiner, as duas coisas que quebram sob a inversão, e confere o contraste no claro e no escuro.
  • Resultados medidos por app. Suporte a clientes de e-mail lista onde as suas cores escuras se aplicam e onde o app recolore o e-mail.

Fontes

Perguntas frequentes

Quais clientes de e-mail suportam a media query prefers-color-scheme?

Segundo o caniemail.com, suporte total: Gmail (todas as plataformas) e Apple Mail (macOS 12.4+/iOS 13.0+). Suporte forte, com ressalvas: Outlook no Windows (2016+), macOS (16.70+), Outlook.com (2019-07+) e mobile (2020-01+) — embora o macOS e o Outlook.com também apliquem seus próprios atributos de dados de modo escuro junto com ela. O Samsung Email (Android 6.1+) também a implementa totalmente. O suporte combinado estimado no painel de clientes testados do caniemail é de 41.86%. Os testes do próprio MailInApp em caixas de entrada reais (outubro de 2026) divergem no Gmail: nenhum app do Gmail aplicou a media query (o Gmail na web manteve o e-mail claro, o app para Android o recoloriu em parte e o app para iOS o inverteu por completo). Ela foi aplicada no Mail no iPhone e no iPad, no iCloud Mail na web, no Outlook.com e nos apps do Outlook para iOS e Android.

O que a meta tag color-scheme realmente faz?

Informa a um cliente compatível para quais esquemas de cor um e-mail foi projetado, para que ele dispense sua própria inversão automática. A adoção está muito atrás da media query: o caniemail.com aponta suporte combinado de apenas 9,76%. Apple Mail, versões recentes do Outlook, Samsung Email e Thunderbird o listam, e o Gmail respeita apenas o valor "light only".

Por que alguns e-mails aparecem invertidos ou desbotados no modo escuro?

Porque vários grandes clientes não respeitam a media query de jeito nenhum — em vez disso, eles a reescrevem em uma sintaxe inválida que nunca dá match (Yahoo Mail, AOL e Fastmail a transformam em @media (_filtered_a), o HEY a transforma em @media (false)) — e recorrem às próprias heurísticas de inversão automática de cor, que é exatamente o que produz logotipos desbotados e texto de baixo contraste ilegível que ninguém projetou explicitamente.

Existe uma única regra CSS que torna um e-mail seguro para modo escuro em todo lugar?

Nenhuma regra cobre todos os casos, e esse é o sentido da divisão em três acima. A abordagem confiável é o aprimoramento progressivo: projete primeiro um e-mail sólido no modo claro, acrescente substituições explícitas de prefers-color-scheme para os clientes que as respeitam e use logos com borda ou fundo sólido para que um cliente que inverte automaticamente não produza um resultado ilegível. No MailInApp, a configuração de Modo escuro do painel Tema (Auto, Personalizado ou Desligado), o alternador de modo escuro na pré-visualização de Clientes e as verificações de modo escuro do preflight fazem isso por você.

Crie para as caixas de entrada que realmente importam

Comece no plano gratuito — todos os blocos interativos e o motor de fallback completo estão incluídos em todos os planos.