---
title: "Solução de problemas de CSS, JavaScript e HTML personalizados na Klaviyo"
description: "Saiba como solucionar problemas de código personalizado ao importar um modelo de HTML personalizado ou criar seu próprio modelo com código personalizado."
canonical_url: "https://help.klaviyo.com/hc/pt-br/articles/115005254488"
markdown_url: "https://help.klaviyo.com/hc/pt-br/articles/115005254488.md"
locale: "pt-br"
category: "Conteúdo"
section: "Como resolver problemas de modelo"
updated: "2025-08-05"
---

# Solução de problemas de CSS, JavaScript e HTML personalizados na Klaviyo

## O que você vai aprender

Saiba como solucionar problemas de código personalizado ao [importar um modelo HTML personalizado](https://help.klaviyo.com/hc/pt-br/articles/115005254068.md) ou criar seu próprio modelo com código personalizado.

**📝 Note:** Recomendamos usar HTML personalizado apenas para profissionais de marketing com conhecimento técnico ou para quem tem acesso a um desenvolvedor. Embora nosso produto ofereça suporte a HTML personalizado, nossa equipe de suporte não pode ajudar você a criar seus modelos personalizados além de oferecer as orientações gerais abordadas nesta documentação.

Para manter a segurança dos seus dados, a equipe de suporte da Klaviyo não pode abrir seus arquivos HTML.

## Elementos personalizados de HTML e CSS

**📝 Note:** Se você estiver criando um modelo HTML personalizado, não poderá usar feed de produtos no seu e-mail.

Alguns elementos de HTML e CSS usados para tornar os e-mails interativos não são compatíveis com todos os clientes de e-mail. Teste seu modelo personalizado nas caixas de entrada que seus destinatários usam, mesmo que ele pareça correto no Klaviyo.

Se a Klaviyo não conseguir processar seu CSS, a geração de uma prévia pode falhar. Verifique a sintaxe do CSS e simplifique a regra que está causando o erro; em seguida, gere a prévia novamente. Para erros envolvendo tags de modelo ou variáveis, consulte [Como solucionar problemas de mensagens de erro de modelo de e-mail](https://help.klaviyo.com/hc/pt-br/articles/4402386684187.md).

## Problemas comuns de HTML

Se você está percebendo que seu e-mail HTML personalizado não está aparecendo corretamente, aqui estão alguns pontos comuns para verificar possíveis problemas.

### Aspas em estilos de font-family

Ao adicionar uma propriedade font-family a um estilo inline, verifique se as aspas ao redor de um nome de fonte não fecham o atributo de estilo do HTML. Por exemplo, use aspas duplas ao redor do atributo de estilo e aspas simples ao redor de Helvetica Neue. Você não precisa remover aspas corretamente pareadas dos nomes de fontes.

| **Problema** | **Fixa** |
| --- | --- |
| <p style='font-family:'Helvetica Neue', Helvetica, Arial;'>Texto</p> | <p style="font-family:'Helvetica Neue', Helvetica, Arial;">Texto</p> |

### Consultas de mídia 

Use uma sintaxe CSS válida para media queries, incluindo chaves ao redor das regras que você quer aplicar. Coloque o exemplo a seguir no <head> do seu modelo. Ele se aplica a elementos com a class mobile-text em telas de até 460px de largura. Ajuste a class, os estilos e a largura para o seu design e, em seguida, teste nos clientes de e-mail dos seus destinatários.

| **Exemplo de consulta de mídia** |
| --- |
| <style> @media only screen and (max-width: 460px) {   .mobile-text {     font-size: 16px;   } } </style> |

### Tags de centralização desnecessárias 

Se você tiver várias tag <center> no seu modelo de e-mail, ele pode não ser renderizado corretamente no Gmail. Para corrigir esse problema, remova todas as tag <center> desnecessárias. Apenas uma tag <center> é necessária no topo do modelo de e-mail, perto da tag <body>. Todas as tag <center> adicionais são supérfluas.

## A Klaviyo não oferece suporte a e-mails com JavaScript

A maioria dos clientes de e-mail (Gmail, Hotmail, Yahoo etc.) considera o JavaScript em e-mails uma ameaça à segurança. Isso acontece porque scripts podem ocultar conteúdo malicioso. Como resultado, esses principais clientes de e-mail bloqueiam totalmente scripts em e-mails. Considerando a ameaça inerente à segurança associada ao JavaScript em e-mails e a falta de suporte a esse tipo de script pela maioria dos principais clientes de e-mail, qualquer script adicionado será removido automaticamente.

## O Klaviyo não oferece suporte a formulários ou vídeos incorporados

A Klaviyo não oferece suporte a formulários incorporados, widgets ou vídeos em modelos. Isso acontece porque nossos testes mostram que esses tipos de recursos não são renderizados de forma confiável em todos os principais clientes de e-mail. De forma semelhante a snippets de JavaScript, a maioria dos clientes de e-mail vê esses elementos como uma ameaça à segurança e os remove completamente dos e-mails.

Se você quiser conhecer soluções alternativas para isso, [confira este artigo sobre como adicionar um vídeo ou GIF a um e-mail](https://help.klaviyo.com/hc/pt-br/articles/115005256968.md).

## Outras tags e atributos sem suporte 

As tags e os atributos HTML abordados aqui não são uma lista completa do que a Klaviyo oferece suporte. Verifique se os elementos que você usa são [compatíveis com os principais provedores de caixa de entrada](https://www.caniemail.com/). A Klaviyo também verifica tags e atributos quando você importa ou salva seu modelo.

Quando você importa ou salva HTML personalizado, a Klaviyo remove elementos não permitidos, como <script> e <iframe>, converte tags não reconhecidas em <span> e remove atributos não compatíveis. Quando você salva as alterações no editor de HTML, revise todos os avisos do tag ou atributo afetado. Se uma parte do seu HTML desaparecer ou mudar, use uma alternativa compatível.

## Verifique suas alterações

1. Clique em **Salvar** no editor de HTML. Revise os erros ou avisos, corrija o código afetado e salve novamente.

2. Clique em **Visualizar**. Se o seu modelo usa dados de perfil ou de evento, escolha o perfil ou o evento com o qual você quer fazer a prévia.

3. Selecione **Enviar como e-mail**, insira seu endereço de e-mail em **Enviar para:** e clique em **Visualizar agora**.

4. Abra o e-mail de pré-visualização no desktop e no celular. Confira o layout, as fontes, os links e qualquer conteúdo interativo. Se você fizer mais alterações, salve e envie outra pré-visualização antes de enviar para seu público.

## Recursos adicionais

- [Como importar um modelo HTML personalizado](https://help.klaviyo.com/hc/pt-br/articles/115005254068.md)
  Saiba como importar um modelo HTML personalizado para a Klaviyo. 
- [Como resolver mensagens de erro em modelos de e-mail](https://help.klaviyo.com/hc/pt-br/articles/4402386684187.md)
  Se você encontrar erros ou avisos em um modelo de e-mail, talvez seja necessário resolvê-los antes de enviar sua mensagem. Pesquise neste recurso a mensagem de erro ou o aviso que você está encontrando para ver dicas de como resolver o problema. 
