Aggregate no n8n: como juntar itens em uma lista

Entenda o nó Aggregate do n8n: para que serve juntar itens, o passo a passo dos modos Individual Fields e All Item Data, cada opção explicada e um exemplo prático.

Por Redação Eleven Host · @robson.direitodigital · 30 de outubro de 2026 · 8 min de leitura

O nó Aggregate no n8n junta itens separados, ou partes deles, em um único item. Ele serve quando você tem vários itens no fluxo e quer trabalhar com eles como uma lista só. Este guia mostra os dois modos, cada opção e um exemplo prático.

O que o Aggregate faz

Para entender o Aggregate, ajuda saber como o n8n enxerga os dados. Segundo a documentação, tudo o que passa entre os nós é uma lista (array) de objetos, e cada objeto é um item. Os dados comuns de cada item ficam na chave json, e os arquivos ficam na chave binary.

A documentação também diz que os nós processam vários itens automaticamente: o nó roda a operação para cada item que recebe. O exemplo dela é um nó do Trello que cria um cartão por item. Daí vem a utilidade do Aggregate, numa dedução deste guia: se três itens chegam a um nó, ele trabalha três vezes; se o Aggregate reúne os três em um item só, o nó seguinte recebe um item.

Na descrição oficial, o nó serve para pegar itens separados, ou partes deles, e agrupá-los em itens individuais. Pense em três itens, cada um com um e-mail. Depois do Aggregate, existe um item com um campo que guarda a lista dos três e-mails.

Quando usar o Aggregate

Use o Aggregate quando o próximo passo do fluxo precisa da lista inteira de uma vez. Alguns casos possíveis:

• enviar uma mensagem só com os dados de vários itens, em vez de uma mensagem por item;
• gravar uma única linha que reúne os valores de vários itens;
• mandar uma lista inteira para uma API numa só chamada.

Como a documentação diz que o nó roda a operação para cada item recebido, a conclusão deste guia é que esses casos pedem um único item na entrada do nó seguinte, e o Aggregate entrega esse item.

Aggregate, Split Out e outros nós

A página de transformação de dados do n8n separa os papéis. O Aggregate agrupa itens separados. O Split Out separa listas em itens individuais. O Summarize agrega dados como uma tabela dinâmica do Excel, e o Code permite escrever JavaScript ou Python para transformações complexas.

Vistos juntos, o Split Out e o Aggregate fazem caminhos contrários: um parte de um item com lista e entrega vários itens, o outro parte de vários itens e entrega um. O guia Split Out no n8n: como separar listas em itens cobre o primeiro. Para agregar valores como numa tabela dinâmica do Excel, a página de transformação de dados lista o Summarize, e não o Aggregate. Para juntar dados de caminhos diferentes do fluxo, existe o Merge, tratado em Merge no n8n: como juntar dados de vários caminhos. Para lógica própria, existe o nó Code, tema de Code no n8n: como usar JavaScript no seu fluxo. Este guia fica só no Aggregate.

Quer montar fluxos de automação como este? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n

Os dois modos do parâmetro Aggregate

O primeiro parâmetro do nó se chama Aggregate e tem duas escolhas: Individual Fields e All Item Data. A escolha muda os campos que aparecem logo abaixo. A diferença, em resumo: no primeiro você indica quais campos juntar e cada um vira a sua própria lista; no segundo você junta os dados dos itens inteiros numa lista só.

Modo Individual Fields, passo a passo

A documentação descreve este modo como aquele que agrega campos individuais separadamente. Use-o quando só interessa um ou poucos campos dos itens, como o e-mail. O roteiro, com os nomes dos parâmetros da tela:

1. Adicione o nó Aggregate depois do nó que entrega os itens.
2. No parâmetro Aggregate, deixe Individual Fields.
3. Em Input Field Name, escreva o nome do campo, nos dados de entrada, que você quer juntar.
4. Se quiser dar outro nome ao campo na saída, ligue Rename Field. Aparece o parâmetro Output Field Name, onde você escreve o novo nome.
5. Execute o nó e confira a saída: um item, com a lista dos valores.

Com os três itens de e-mail do exemplo acima, e Input Field Name igual a email, a saída é um item com o campo email contendo a lista dos três e-mails. Com Rename Field ligado e Output Field Name igual a emails, o mesmo campo sai com o nome emails.

Modo All Item Data, passo a passo

Neste modo, a documentação diz que o n8n junta todos os dados dos itens numa lista só. Use-o quando o item inteiro importa, e não só um campo. O roteiro:

1. No parâmetro Aggregate, escolha All Item Data.
2. Em Put Output in Field, escreva o nome do campo onde a lista vai ficar. Por exemplo, data.
3. Em Include, escolha quais campos de cada item entram: All fields, Specified Fields ou All Fields Except.
4. Com Specified Fields, preencha Fields To Include. Com All Fields Except, preencha Fields To Exclude. Nos dois casos, separe os nomes por vírgula.

Na mesma entrada de três itens, com Put Output in Field igual a data e Include em All fields, a saída é um item com o campo data, que guarda uma lista com os três itens inteiros.

Qual modo escolher

• Precisa só de um valor de cada item, como uma lista de e-mails? Individual Fields.
• Precisa levar os itens completos, ou vários campos de cada um, para o próximo nó? All Item Data, com o Include adequado.
• Precisa de todos os campos menos alguns? All Item Data com All Fields Except.

As opções do nó Aggregate

Além dos parâmetros, o nó tem quatro opções. Algumas só existem em um dos modos:

• Disable Dot Notation (só em Individual Fields): impede que você acesse um campo filho com pai.filho. Vem desligada.
• Merge Lists (só em Individual Fields): ligue se o campo a juntar já é uma lista e você quer uma única lista plana na saída, em vez de uma lista de listas.
• Include Binaries (nos dois modos): inclui na saída os dados binários da entrada. Atenção ao nome: no Aggregate é Binaries, no plural. No Split Out é Include Binary.
• Keep Missing And Null Values (só em Individual Fields): com a opção ligada, o n8n acrescenta uma entrada vazia (null) na lista quando o valor falta ou é null. Desligada, ele pula esse valor.

Um exemplo nosso de Merge Lists, montado a partir da descrição da opção: se cada item tem um campo tags com uma lista, juntar o campo tags dos itens dá uma lista de listas. Com Merge Lists ligada, a saída é uma lista única com todos os elementos.

Exemplo prático: juntar e-mails para um único envio

Este exemplo é nosso, montado só com as opções descritas acima, e os nomes de campo são fictícios. Imagine um fluxo que lê uma lista de contatos e entrega um item por contato, cada um com os campos nome e email. Você quer um único aviso para a equipe, com todos os e-mails.

1. Depois do nó que entrega os contatos, adicione o Aggregate.
2. Deixe o modo Individual Fields.
3. Em Input Field Name, escreva email.
4. Ligue Rename Field e, em Output Field Name, escreva emails.
5. Execute o nó. A saída é um item só, com o campo emails guardando a lista.

No nó seguinte, o campo emails está dentro da chave json do item. Pela dedução deste guia, como o nó seguinte roda a operação para cada item recebido e agora há um item só, o envio deve acontecer uma vez. O guia Enviar e-mail no n8n: como usar o nó Send Email explica o nó de envio. Como usar a lista dentro dele depende de como você montar a mensagem; teste na tela antes de depender dela.

Se, em vez dos e-mails, você precisasse dos contatos completos, trocaria para All Item Data, com Put Output in Field igual a contatos e Include em Specified Fields, com nome,email em Fields To Include.

Procura um lugar para os seus fluxos do n8n? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n Essencial

Perguntas frequentes

Para que serve o Aggregate no n8n?

Ele pega itens separados, ou partes deles, e os agrupa em um item só, com os dados numa lista.

Qual a diferença entre Individual Fields e All Item Data?

No Individual Fields, você escolhe os campos e cada um é agregado separadamente. No All Item Data, os dados de todos os itens vão para uma lista só, no campo indicado em Put Output in Field.

O Aggregate faz o contrário do Split Out?

Pelas descrições da documentação, o Split Out separa uma lista em itens, e o Aggregate agrupa itens. Os dois fazem caminhos contrários.

O Aggregate soma ou conta os itens?

O Aggregate agrupa itens em um só. Para agregar valores como numa tabela dinâmica do Excel, a página de transformação de dados lista o nó Summarize.

Como renomear o campo na saída?

No modo Individual Fields, ligue Rename Field e escreva o novo nome em Output Field Name.