Criar e ativar scripts

Os scripts são escritos na API de Scripts da Shopify. Essa API é uma versão da linguagem de programação Ruby. Portanto, é preciso ter experiência em programação com Ruby. Use o Script Editor para criar, editar, testar e publicar os scripts.

Requisito de plano

Os Scripts da Shopify foram descontinuados em 30 de junho de 2026. Todos os scripts que ainda estavam publicados na loja foram desativados e não funcionam mais. Para recriar essas personalizações, faça a transição para o Shopify Functions. Saiba mais sobre como migrar dos Scripts da Shopify para o Shopify Functions.

Antes de começar a escrever um script, analise os diferentes tipos de script (item de linha, frete e pagamento) para saber quais são os métodos aceitos por cada tipo de script. Por exemplo, um script de item de linha não pode usar formas de frete.

Apenas um script de cada tipo pode ser publicado por vez. Por exemplo, é possível publicar um script de itens de linha e um script de taxas de frete, mas não é possível publicar dois scripts de itens de linha ao mesmo tempo.

Canais de vendas compatíveis

Ao criar (ou editar) um script, você escolhe se ele será executado apenas na sua loja virtual ou na sua loja virtual e nos seguintes apps:

• Apps personalizados criados com a Storefront API, o JavaScript Buy SDK e os Mobile Buy SDKs (Android e iOS)
• Apps personalizados que geram checkouts
• Criadores de apps para dispositivos móveis Tapcart, Plobal Apps e Vajro

Observação

Para instalações de apps que ocorrem após a última atualização de um script, publique novamente o script para garantir que ele seja executado como esperado no contexto do app recém-instalado.

É possível encontrar exemplos de scripts comuns nos modelos de script fornecidos no Script Editor. Para ver esses modelos, é preciso criar um script.

Criar um script

Para criar um script:

Consulte a API de Scripts da Shopify como referência para escrever códigos para scripts.

1. Abra o Script Editor. A página de visão geral “Scripts” exibe uma lista de scripts da loja.
2. Clique em “Criar script” para começar a criar um novo script.
3. Na caixa de diálogo “Selecionar modelo de script” :
   1. Escolha o tipo de script que você quer criar.
   2. Escolha um modelo de exemplo como ponto de partida ou escolha “Modelo em branco” para começar a escrever um script do zero.
   3. Clique em “Criar script” para criar um script com o tipo que você escolheu.

      Dica

      O tipo de script escolhido (Itens de linha, Taxas de frete ou Gateways de pagamento) determina o tipo do script e os métodos que ele pode usar.

4. Na caixa **“Título”**, insira um nome para o script. Use um nome descritivo para que seja possível identificar a função do script rapidamente. 5. Clique em **“Código”** para abrir o console de **código-fonte Ruby**. 6. Insira o código do script. Use a [documentação da API de Scripts da Shopify](/manual/checkout-settings/script-editor/shopify-scripts) como referência. 7. Clique em **“Executar script”** para executar o script. 8. Quando terminar: * Clique em **“Salvar rascunho”** para salvar um rascunho não publicado do script. * Clique em **“Salvar e publicar”** para criar e publicar o script.

Próximas etapas

Depois de escrever um script, é preciso testá-lo e depurá-lo antes de publicá-lo. Também é possível atualizar os arquivos de modelo do Liquid para que a vitrine virtual responda às alterações feitas pelos scripts.