Como o n8n processa itens
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.
