Suporte: seg. a sex., das 9h às 18h

O que são Snippets?

Atualizado em 22/10/2026

Snippet quer dizer "trecho de código". Na prática, são pedaços de código que ferramentas externas fornecem (de marketing, remarketing, análise de acessos, vídeos, widgets de terceiros) e que você integra à loja para adicionar uma funcionalidade.

A lista fica em Marketing & SEO > Snippets, e o botão Adicionar abre o cadastro. Na lista, cada snippet mostra o nome, a página em que roda e a posição do código, e o menu do nome leva a Editar, Histórico de edições, Arquivar e Apagar.

O que você configura em cada snippet

O cadastro tem quatro seções:

  • Status e validade — liga ou desliga o snippet e define as datas Validade de e Validade até. Fora desse período o código não roda, o que ajuda em campanhas com data para acabar.
  • Onde o código entra — o Nome do snippet (um lembrete que só a equipe vê, para achar o código no painel), a Página em que ele roda e a Posição no HTML.
  • Código — o trecho em si, colado exatamente como veio.
  • Valores da página — a lista de tokens que a loja troca pelo valor da página (explicada mais abaixo).

Na Página, escolha entre todas as páginas, todas exceto o checkout, a página inicial, as categorias, os produtos, o contato, o carrinho ou uma etapa específica do checkout (cliente, endereço, frete, pagamento, boleto, crédito, revisão, pedido feito e negado). Siga a recomendação de quem forneceu o código.

Na Posição no HTML, o fornecedor costuma indicar qual usar, e isso define o momento em que o script carrega:

  • Dentro do head — para scripts de rastreamento e meta tags.
  • No início do body — para o que precisa carregar cedo.
  • No fim do body — para o que pode carregar por último, como widgets e ferramentas de análise.

Atenção: o código entra na loja como foi escrito, sem revisão. Evite comentários de JavaScript (// ou / /) no meio dele, que podem quebrar o código vizinho.

Valores da página (tokens)

Alguns códigos precisam do número do produto, do pedido ou do total da compra. Escreva o token no código, e a loja o troca pelo valor da página em que o snippet roda. Em outra página, o token sai como foi escrito.

  • Categorias — {CatId}, o código da categoria.
  • Produtos — {ProdId}, o código do produto.
  • Carrinho e pedido feito — {ProdIds}, {FBIds} e {PedidoTotal}.
  • Só no pedido feito — {PedidoId}, {PedidoQtde}, {PedidoTotalDesconto}, {PedidoGeral}, {PedidoClienteNome}, {PedidoClienteEmail} e {UsuarioEmail}.

A tela do cadastro traz cada token com a explicação e um botão para copiá-lo.

Antes de sair colando código

Dois cuidados valem a pena:

  • Performance — todo script externo é um servidor a mais que a página espera responder, então use com critério e só de parceiros confiáveis.
  • Quando não usar snippet — para as ferramentas mais populares (Google Analytics, Pixel do Facebook, do TikTok, do Pinterest, verificação de domínio, entre outras), a loja tem uma tela própria, mais segura e otimizada, em Marketing & SEO > Integrações.

Prefira sempre a tela de Integrações para esses casos.

O botão Crawlers, no alto da lista, abre os arquivos que orientam buscadores e assistentes de IA (Robots.txt e LLMs.txt), que têm artigos próprios.