O gatilho de atualização de produto do Shopify Flow e os gatilhos de produto deste aplicativo
Veja o que o gatilho Produto atualizado do Shopify Flow envia, seu limite de cinco campos e quais gatilhos trazem valores anteriores e variação de preço.
O gatilho Produto atualizado do Flow inicia um fluxo de trabalho quando ocorre uma alteração em um dos até cinco campos de um produto, de suas variantes, opções ou mídia. A página de ajuda do Shopify explica o que o fluxo de trabalho recebe: “O gatilho ‘Produto atualizado’ fornece apenas os valores atuais do produto e de suas variantes, opções e mídia.” e “Os valores anteriores dos campos que foram alterados não estão disponíveis no fluxo de trabalho.”
Este aplicativo possui um gatilho para cada tipo de alteração no produto, e cada um deles contém os valores anteriores e posteriores: o preço antigo e o novo, com a diferença em porcentagem; o link antigo para redirecionamento; e as tags que foram adicionadas ou removidas. Esta página compara esses dados campo a campo. As informações sobre o gatilho do Flow foram extraídas da página de ajuda Shopify e de nossos testes realizados em uma loja de desenvolvimento nos dias 26 de outubro e 20 de novembro de 2026.
O que o “Product updated” envia
Um fluxo de trabalho iniciado pela atualização do produto pode ser o seguinte:
| Variável | Conteúdo | Sempre presente |
|---|---|---|
product |
o produto, valores atuais | sim |
shop |
a loja | sim |
productVariant |
uma variante que sofreu alteração, valores atuais | somente quando um campo de variante estiver sendo monitorado e uma variante for alterada |
| Opção de produto, mídia, produto com listagem combinada | o item que sofreu alteração | somente quando tal campo for monitorado |
O que não é enviado:
- Não há valor anterior. Não há preço anterior, título anterior, status anterior nem lista de tags anterior.
- Não há uma lista de campos alterados para servir de base à ramificação. O Flow mostra os caminhos alterados nos dados da etapa de uma execução, mas, em nossos testes, eles não foram disponibilizados como variáveis no editor de fluxo de trabalho.
- Não há números relativos à variação: nem diferença, nem variação percentual, nem direção.

Quais produtos atualizados podem ser visualizados
| Grupo | Campos |
|---|---|
| Produto | category, combinedListingRole, descriptionHtml, giftCardTemplateSuffix, handle, metafield.value, productType, requiresSellingPlan, status, tags, templateSuffix, title, vendor |
| Variantes | variants.barcode, variants.barcodes, variants.compareAtPrice, variants.inventoryPolicy, variants.media, variants.metafield.value, variants.position, variants.price, variants.productVariantComponents, variants.requiresComponents, variants.showUnitPrice, variants.taxable, variants.title |
| Mais grupos | mídia, opções e valores das opções, componentes do pacote, listagens combinadas |
Não constam na lista: SKU, custo por item e peso (esses dados pertencem ao item de estoque; consulte O gatilho de atualização de item de estoque do Flow e o SKU, o custo e o estoque neste aplicativo), o preço unitário, as quantidades em estoque e os canais de vendas.
O limite de cinco campos
Cada gatilho de atualização de produto monitora de 1 a 5 campos. O limite se aplica por fluxo de trabalho, e não por loja: em nosso teste, dois fluxos de trabalho com cinco campos cada foram executados em uma única edição. Para monitorar mais campos, crie mais fluxos de trabalho e repita suas condições e ações.
Este aplicativo não possui tal limite. Cada campo rastreado possui seu próprio gatilho, e o gatilho genérico Atualização de produto pode ser restringido a qualquer número de campos em suas configurações. Consulte Monitore mais de cinco campos em um único fluxo de trabalho.

Campo por campo
| O que mudou | Atualização do produto da Shopify Flow | Gatilho da funcionalidade principal deste aplicativo | Antes e depois |
|---|---|---|---|
| Preço | variants.price: apenas novo valor |
Alteração no preço da variante do produto | priceChange.oldPrice, newPrice, delta, percentChange, direction |
| Preço de comparação | variants.compareAtPrice: apenas o novo valor |
Alteração no preço da variante do produto | priceChange.oldCompareAtPrice, newCompareAtPrice |
| Preço unitário | não consta na lista (apenas variants.showUnitPrice) |
Alteração no preço unitário da variante do produto | unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction |
| Custo por item | não em “Produto atualizado”. A atualização do item de estoque inclui unitCost; apenas o novo valor |
Alteração no custo da variante do produto | variantCostChange.oldCost, newCost, delta, percentChange, direction |
| SKU | não em “Produto atualizado”. A atualização do item de estoque inclui o sku; apenas o novo valor |
Alteração do SKU da variante do produto | skuChange.oldSku, newSku |
| Código de barras | variants.barcode, variants.barcodes, apenas novo valor |
O código de barras da variante do produto foi alterado | o código de barras principal antigo e o novo, as listas de códigos de barras antigas e novas, e o que foi adicionado e removido |
| Estoque em um local | não consta da lista | Alteração no nível de estoque no local, sem estoque no local, estoque restabelecido no local | inventoryLevel.oldAvailable``newAvailable``delta e a localização |
| Título | title: somente novo valor |
Alteração do título do produto | oldTitle, newTitle |
| Alça | handle: apenas novo valor |
Alteração do nome do produto | oldHandle e newHandle, prontos para um redirecionamento de URL |
| Descrição | descriptionHtml: apenas valor novo |
Descrição do produto alterada | oldDescription, newDescription |
| Status | status: apenas novo valor |
Alteração no status do produto | oldStatus, newStatus |
| Fornecedor | vendor: somente novo valor |
Mudança do fornecedor do produto | oldVendor, newVendor |
| Tipo de produto | productType: somente novo valor |
Alteração do tipo de produto | oldType, newType |
| Tags | tags: a lista após a alteração |
Tags de produto adicionadas, Tags de produto removidas | addedTags, removedTags, previousTags, currentTags |
| Canais de vendas | não consta da lista | Produto publicado no canal, produto retirado do canal | channels.added, channels.removed, channels.current |
| Metacampo do produto | metafield.value: apenas o novo valor |
Atualização do metacampo do produto | metafield.value, metafield.previousValue |
| Metacampo de variante | variants.metafield.value: apenas novo valor |
Atualização do metacampo de variantes do produto | metafield.value, metafield.previousValue |
| Várias dessas etapas em um único fluxo de trabalho | cinco, no máximo | Atualização do produto, restrita aos campos que o(a) senhor(a) marcar | changes.fields e changes.items com field, oldValue e newValue, um item por variante |
| Opções, mídia, modelo e outros campos do produto | sim, dentro dos cinco campos | A atualização do produto foi restrita a esses campos. Quanto aos valores anteriores e posteriores, o modelo de gatilho personalizado Campos do produto alterados (antes e depois) | |
| Componentes de pacotes, listagens combinadas | sim, dentro dos cinco campos | sem gatilho |
Diferenças de comportamento que vale a pena conhecer
- Um novo produto. A página de ajuda do Shopify informa que, dependendo dos campos que você monitora, a adição de um produto também pode acionar o fluxo de trabalho: todo produto possui pelo menos uma variante; portanto, um fluxo de trabalho que monitore
variants.priceé executado quando um produto é adicionado. Os gatilhos de alteração deste aplicativo reconhecem um novo produto e são acionados a partir da primeira alteração efetiva do mesmo. - Vários campos em um único salvamento. O gatilho Flow é executado uma única vez e não informa qual campo foi alterado. Este aplicativo aciona o gatilho correspondente para cada tipo de alteração, cada um com seus próprios valores antes e depois.
- Um salvamento que não altera nada também não dá início a nada.
- Análise retrospectiva. O fluxo de trabalho das lojas do Shopify permanece ativo por 14 dias após a conclusão de uma execução. Este aplicativo possui seu próprio Histórico de Eventos com os valores de cada evento, além de um bloco de eventos na página do registro no painel de administração do Shopify. Consulte Histórico de eventos e solução de problemas e Gatilhos na página de administração de um registro.
Fluxos de trabalho que precisam do valor antes de
- Redirecione a URL antiga quando um identificador for alterado. O redirecionamento ocorre de
oldHandleparanewHandle. Sem o identificador antigo, não há de onde realizar o redirecionamento. Redirecionar URLs antigas de produtos quando o identificador de um produto for alterado - Marque uma redução de preço real.
priceChange.percentChange. Um valor menor ou igual a-10distingue uma queda de preço de 10% de todas as outras alterações de preço. Marque os produtos quando o preço de uma variante cair 10% ou mais - Marque um produto como em promoção e desmarque-o. O preço de comparação estava em branco e agora está definido, ou vice-versa. Marque os produtos como em promoção quando for adicionado um preço de comparação e Remova a tag de promoção quando o preço de comparação for removido
- Marcar novidades. A condição “Status do produto alterado com
oldStatusigual adraftenewStatusigual aactive” é verdadeira quando um produto é publicado, e não quando um produto arquivado é restaurado. Tag os produtos como novidades quando seu status passar para “ativo” - Manter o título ou o SKU anterior. Salvar o título anterior quando o título de um produto for alterado e Salvar o SKU anterior quando o SKU de uma variante for alterado
- Seja notificado quando um produto for retirado de um canal de vendas. Marque os produtos quando forem retirados da Loja virtual
Qual deles utilizar
- Atualização do produto no Shopify Flow: basta saber que um dos até cinco campos foi alterado, ou acompanhar opções, mídias, componentes de pacotes ou listagens combinadas.
- Esta aplicação: seu fluxo de trabalho compara situações “antes e depois” (quedas de preço, produtos renomeados, tags removidas), necessita de SKU, custo e estoque por local ou canal de vendas em um único local, ou monitora mais de cinco campos em um único fluxo de trabalho.
Ambos podem ser executados na mesma loja.
A função “Atualizar produto” exibe o preço antigo?
Não. A página de ajuda do Shopify informa que o gatilho fornece apenas os valores atuais. O gatilho “Alteração no preço da variante do produto” apresenta o preço antigo e o novo, a diferença, a variação em porcentagem e a direção.
A função “Atualização de produto” é executada quando um produto é criado?
Sim, é possível. A página de ajuda do Shopify informa que um fluxo de trabalho que monitora um campo de variante, como variants.price, é executado quando um produto é adicionado, pois todo produto possui pelo menos uma variante. Definir campos do produto, como título ou tags, no momento em que um produto é adicionado, não aciona esse fluxo de trabalho.
A função “Atualização de produto” permite monitorar o SKU ou o custo?
Não no produto. O Shopify incluiu ambos no item de estoque: o gatilho “Item de estoque atualizado” pode monitorar sku e unitCost, mais uma vez apenas com o valor atual. Os gatilhos “Alteração no SKU da variante do produto” e “Alteração no custo da variante do produto” apresentam os valores antes e depois.
Como faço para reagir apenas a uma queda de preço de um determinado valor?
Utilize a condição “Preço da variante do produto alterado” com uma condição baseada em priceChange.percentChange, por exemplo, “Menor ou igual a -10”. O aplicativo calcula a porcentagem, pois uma condição do Shopify Flow não é capaz de fazer esse cálculo.
Próximos passos
- Gatilhos de produto, passo a passo e Gatilhos de variantes do produto, passo a passo - todos os gatilhos de produto e variante, acompanhados de um exemplo.
- Os gatilhos atualizados do Flow e as Workflow Trigger Extensions - visão geral de todos os nove gatilhos atualizados.
- Valores antigos e novos: como um fluxo de trabalho pode aproveitá-los - todos os valores anteriores e posteriores, por gatilho.
