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.