Migração dos Scripts da Shopify para o Shopify Functions

O Shopify Functions é semelhante aos Scripts da Shopify, que permitem aos desenvolvedores criar experiências de comércio personalizadas.

Requisito de plano

Os Scripts da Shopify e o app Script Editor estão disponíveis apenas para lojas no plano Shopify Plus. O app Script Editor não está mais disponível para download na Shopify App Store.

Em 28 de agosto de 2025, os Scripts da Shopify serão removidos e não funcionarão mais. Por isso, migre os scripts existentes para o Shopify Functions antes dessa data.

Shopify Functions

O Shopify Functions é instalado como parte de um app. Ele é configurado junto com outros recursos diretamente no admin da Shopify, ou seja, os lojistas não precisam usar código quando estão criando ou modificando personalizações. A plataforma WebAssembly, que executa o Shopify Functions, oferece um desempenho melhor que os Scripts da Shopify e executa códigos em até cinco milissegundos. Isso possibilita que o Shopify Functions aceite grandes eventos de vendas, como vendas-relâmpago, sem diminuição do desempenho.

Com o Shopify Functions, os desenvolvedores podem testar o código e a unidade em seu próprio ambiente local. Além disso, eles distribuem as personalizações do Shopify Functions como parte de um app, em vez de copiar e colar o código Ruby em cada loja. Por último, também há uma redução dos problemas de limitação de tempo e de memória da CPU.

Migração para Shopify Functions com o relatório de personalizações de Scripts da Shopify

O relatório de personalizações de Scripts da Shopify é uma página personalizada no admin da Shopify que exibe as personalizações do Scripts ativos em sua loja. Além disso, ele fornece documentação sobre Shopify Functions ou links para apps relevantes que podem ajudar você a recriar as personalizações.

Os relatórios personalizados dos Scripts da Shopify são gerados automaticamente. Você também pode exportar seu relatório e visualizá-lo como um arquivo CSV. Você precisa recriar sua personalização usando Shopify Functions antes de 28 de agosto de 2025.

Análise das suas personalizações

Dependendo dos seus scripts, sua página de relatório pode conter seções para personalizações de Gateways de pagamento, Frete e Descontos em produtos.

Cada seção pode incluir o nome, a descrição e os links do arquivo de origem dos seus Scripts da Shopify personalização, links para apps recomendados que são criados com Shopify Functions e que são específicos para sua personalização, e links para o tutorial do Shopify Functions .

Analise as informações do relatório para decidir se deseja recriar sua personalização com as seguintes opções:

• Crie sua própria solução usando Shopify Functions
• Instale apps criados com base no Shopify Functions

Observação

Os apps baseados no Shopify Functions precisam usar a App Bridge da Shopify, que não é compatível com os apps personalizados criados no admin da Shopify. Portanto, é necessário criar os apps personalizados baseados no Functions com uso do Painel de Parcerias e depois conectá-los à loja.

Recriar sua personalização

1. No admin da Shopify, acesse Configurações > Apps e canais de vendas.

2. Clique em Script Editor.

3. No banner Substitua seus Scripts da Shopify, clique em Substitua seus scripts da Shopify.

4. Em cada seção do seu Relatório de personalização, faça qualquer uma das ações a seguir:

   • Para visualizar suas personalizações de Scripts da Shopify existentes, clique no nome do script abaixo do número de personalizações Detecção automática.
   • Para visualizar ou instalar apps compatíveis que correspondam aos seus scripts, na seção Apps recomendados, clique em Instalar para um app que você deseja usar ou clique em Mais apps desse tipo para encontrar outros apps compatíveis.
   • Para visualizar o tutorial Shopify Functions, na seção Como recriar com Shopify Functions, clique no link de API da função relevante.

Após testar com sucesso um app ou uma personalização Shopify Functions , você pode desativar o script que está substituindo.

Usar Scripts da Shopify com Shopify Functions

Os Scripts da Shopify continuarão funcionando nos checkouts personalizados com checkout.liquid e naqueles que fizeram upgrade até 28 de agosto de 2025.

É possível usar os Scripts da Shopify e o Shopify Functions ao mesmo tempo em uma única loja. Se não for possível substituir os scripts pelo uso do Shopify Functions, continue a usá-los até que as APIs do Shopify Functions ofereçam os recursos necessários. Consulte as seções abaixo para saber como ocorre a interação entre os Scripts da Shopify e o Shopify Functions.

Scripts de itens de linha

Os scripts de itens de linha são executados antes do Shopify Functions, que inclui descontos criados por apps. Esses scripts não podem acessar os valores que foram descontados por funções e apps.

Os scripts podem acessar apenas o primeiro código de desconto aplicado ao checkout e não têm acesso a outros códigos de desconto que possam ter sido usados. Por exemplo, o uso de reject opera no primeiro desconto aplicado ao checkout, sem afetar os demais.

Scripts de frete

Os scripts de frete são executados após as personalizações de entrega criadas pelo Shopify Functions. Vale destacar que eles não funcionam em resultados modificados de renomeação dessas personalizações, mas a operação não é afetada no caso de personalizações que movem ou ocultam.

Scripts de pagamento

Os scripts de pagamento são executados após personalizações de pagamento criadas pelo Shopify Functions. Vale destacar que eles não funcionam em resultados modificados de renomeação dessas personalizações, mas a operação não é afetada no caso de personalizações que movem ou ocultam.