Ir para o conteúdo
Promovaweb

Como o n8n processa itens

Revisado em

Antes de começar

Prever quantas vezes cada node do seu workflow vai rodar.

  • Ter lido o guia Itens e JSON.

O n8n trata a entrada de cada node como uma lista de itens. A maioria dos nodes roda uma vez para cada item recebido. Três itens na entrada de um node que envia e-mail resultam em três e-mails.

Quando o node roda uma vez só

Estes casos fogem desse padrão:

Situação Comportamento
Opção Execute Once ligada no node O node processa só o primeiro item
Code node em Run Once for All Items O código roda uma vez e recebe todos os itens
Code node em Run Once for Each Item O código roda uma vez por item
Nodes de agregação, como Aggregate e Summarize Juntam vários itens em um resultado

O modo Run Once for All Items é o padrão do Code node. Um código escrito para um item por vez precisa do outro modo ou de um laço sobre a lista.

Por que isso importa

Um node que deveria mandar um resumo diário, recebendo cem itens, manda cem mensagens se ninguém juntar os itens antes. O inverso também acontece: um node com Execute Once ligado processa só o primeiro registro e ignora os outros sem erro.

Como conferir

Execute o workflow com poucos itens de teste. Em cada node, compare o número de itens na entrada e na saída. O painel mostra esse número no topo das duas colunas. Quando o número muda de um node para o outro, procure a configuração responsável antes de seguir.

Confira o resultado

Em um workflow de teste com três itens, você confere na saída quantas vezes cada node rodou.

Fontes e conferência

Conteúdo conferido na documentação oficial do n8n em 28 de outubro de 2026.