O que mudou em outubro de 2026

Desde 1º de outubro de 2026, a Shopify bloqueou as mutations scriptTagCreate e scriptTagUpdate da GraphQL Admin API. Isso vale para todas as versões da API, não apenas a mais recente. Apps que dependem de script tags para injetar código na storefront não conseguem mais criar nem atualizar esses scripts.

Os script tags que já existiam continuam funcionando, mas com prazo de validade: em 1º de março de 2027, a Shopify vai parar de injetar script tags nas páginas da loja. A partir dessa data, qualquer rastreamento que dependa exclusivamente de script tags vai parar de funcionar.

O que já parou de funcionar

Antes mesmo de outubro, a Shopify já havia desativado os scripts na página de status do pedido (Thank You page) em 26 de agosto de 2026. Lojas que usavam Additional Scripts para rastrear conversões nessa página e não migraram já estão sem dados de conversão há quase dois meses.

Se o seu pixel do Facebook, Google Ads ou outra plataforma de mídia roda via script tag ou Additional Scripts, confira agora se está funcionando. A forma mais rápida de testar: faça uma compra de teste e verifique se o evento de conversão aparece nas plataformas de anúncio.

Para onde migrar

A Shopify oferece dois caminhos, dependendo do que o script faz:

Web Pixels API: para scripts que coletam dados de analytics, rastreamento de conversões e eventos de marketing. O Web Pixel roda em uma sandbox segura, isolada do HTML da página. Em vez de ler elementos do DOM, o código se inscreve em eventos padrão de e-commerce (product_viewed, add_to_cart, checkout_completed) e recebe os dados estruturados.

App embed blocks (Theme App Extensions): para scripts que modificam a interface da loja, como banners, pop-ups ou widgets. Esses blocos são inseridos no tema via extensão e não dependem de script tags.

Como funciona a Web Pixels API

A Web Pixels API usa eventos padronizados. Seu código se registra como um pixel customizado ou de app e recebe chamadas automáticas quando o evento acontece. A principal mudança de mentalidade é que você não lê o HTML da página; você escuta eventos.

Exemplo: em vez de procurar o ID do produto no DOM da página de produto, você se inscreve no evento product_viewed e recebe o ID, título, preço e variante diretamente nos dados do evento. Isso é mais confiável e não quebra quando o tema muda.

O pixel roda em sandbox. Ele não acessa o document, o window da página principal nem outros scripts. Se seu código atual faz manipulação de DOM ou leitura de cookies primários, vai precisar ser reescrito.

Passo a passo da migração

Primeiro, faça um inventário: liste todos os script tags ativos na sua loja (Configurações > Customer Events ou via API). Identifique quais fazem rastreamento (migram para Web Pixels) e quais modificam a UI (migram para app embeds).

Segundo, verifique se os apps que você usa já migraram. Apps como o Facebook Channel, Google Channel e TikTok Channel da Shopify já usam Web Pixels nativamente. Se seu tracking é via app oficial, pode ser que já esteja migrado sem que você saiba.

Terceiro, para pixels customizados, crie um Custom Pixel no painel (Configurações > Customer Events > Adicionar pixel customizado). Cole o código adaptado para a nova API, mapeando cada script antigo para os eventos equivalentes.

Quarto, teste antes de desativar o script antigo. Rode os dois em paralelo por uma semana e compare os números. Só desative o script tag quando os dados do novo pixel estiverem consistentes.

Armadilhas comuns

Bloqueadores de anúncio e o ITP do Safari afetam tanto script tags quanto Web Pixels. A migração não resolve esse problema. Para conversões de compra críticas, considere adicionar tracking server-side via Conversions API (CAPI) do Facebook ou Google Ads Data Manager.

Outra armadilha: testar apenas no desktop. O comportamento de bloqueio de scripts é diferente no Safari mobile, Chrome e navegadores in-app (Instagram, TikTok). Teste em pelo menos três cenários.

Prazo final

O cenário é este: script tags novos já não podem ser criados. Os que existem rodam até 1º de março de 2027. Quem não migrar até lá perde todo o rastreamento baseado em script tags. Comece o inventário esta semana.