Split Out no n8n: como separar listas em itens

Entenda o nó Split Out do n8n: quando usar, o passo a passo com Field to Split Out e Include, as opções, o contrário com o Aggregate e um exemplo com pedidos de uma API.

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

O Split Out no n8n é o nó que pega um campo com uma lista dentro de um item e transforma cada elemento dessa lista em um item separado. Os nós seguintes recebem esses itens e processam cada um individualmente.

Neste guia você vê o que são itens no n8n, quando usar o Split Out, o passo a passo com os nomes exatos dos campos, as opções do nó, a diferença para o Aggregate e um exemplo com uma lista de pedidos.

O que são itens no n8n

Para entender o Split Out, comece pelo que o n8n chama de item. Segundo a documentação, os dados passados entre os nós são uma lista (array) de objetos, e cada objeto dessa lista é um item. Os dados comuns de cada item ficam na chave json, e os arquivos ficam na chave binary.

Quando um nó recebe vários itens, ele processa cada item individualmente e faz a operação configurada para cada um. O exemplo da documentação é um nó do Trello que recebe dois itens e cria dois cartões.

Quando você arrasta um campo, o n8n cria uma expressão como {{ $json.fruit }}, que pega o valor daquele campo em cada item.

Agora imagine um único item com um campo que guarda uma lista de vários elementos. Para o n8n, isso continua sendo um item só. É aí que entra o Split Out.

Quando usar o Split Out

Use o Split Out quando os dados chegam com a lista dentro de um único item e você quer trabalhar com um elemento de cada vez. A documentação dá o exemplo de uma lista de clientes: o nó a transforma em um item por cliente.

Um caso possível é a resposta de uma API que traga uma lista dentro de um campo. O guia HTTP Request no n8n: como chamar uma API no fluxo mostra como fazer essa chamada. Se a lista vier dentro de um único item, o Split Out é o passo seguinte para separá-la.

Como cada nó processa os itens individualmente, depois do Split Out a operação seguinte roda para cada elemento da lista. É o mesmo comportamento do exemplo do Trello: dois itens, duas operações.

Passo a passo do Split Out

Este roteiro usa os nomes dos parâmetros como aparecem na documentação do nó. Ele parte de um nó anterior que entrega um item com uma lista em um campo.

1. Adicione o nó Split Out depois do nó que entrega o item com a lista.
2. No parâmetro Field to Split Out, informe o campo que tem a lista a separar. Se for um dado binário, a documentação manda usar $binary numa expressão.
3. No parâmetro Include, escolha se os outros campos da entrada vão junto em cada item novo.
4. Execute o nó e olhe a saída: a lista deve ter virado um item por elemento.

As três escolhas do Include

• No Other Fields: nenhum outro campo da entrada acompanha o item novo.
• All Other Fields: os outros campos da entrada vão junto em cada item novo.
• Selected Other Fields: só os campos que você escolher vão junto. Essa escolha abre o parâmetro Fields to Include, onde você digita os nomes separados por vírgula.

O Include importa quando o item de entrada tem outros campos além da lista, como o nome da loja ou a data da consulta. Com All Other Fields ou Selected Other Fields, esses dados acompanham cada item novo.

Opções do nó Split Out

Em Node options a documentação lista três opções:

• Disable Dot Notation: a notação com ponto (pai.filho), usada para acessar campos internos, vem ligada. Esta opção a desliga.
• Destination Field Name: o campo de saída onde o conteúdo separado é colocado.
• Include Binary: inclui na saída os dados binários da entrada. Vem desligada.

A notação com ponto vem ligada e serve para acessar campos internos no formato pai.filho. Se você precisar do comportamento sem ela, é a opção Disable Dot Notation que a desliga.

Procura um plano de n8n? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n

O caminho contrário: Aggregate

O Split Out separa uma lista em itens. O nó Aggregate faz o caminho contrário: pega itens separados, ou partes deles, e os agrupa. A documentação do Aggregate tem dois tipos:

• Individual Fields: agrega cada campo indicado separadamente. Usa os parâmetros Input Field Name, Rename Field e, se ligado, Output Field Name.
• All Item Data: junta os dados dos itens numa só lista. Usa Put Output in Field, Include (All fields, Specified Fields ou All Fields Except) e Fields To Include ou Fields To Exclude.

O Aggregate também tem opções: Disable Dot Notation, Merge Lists (achata listas numa só), Include Binaries e Keep Missing And Null Values (adiciona uma entrada vazia para valores nulos ou ausentes).

Se depois de separar a lista você quiser agrupar itens de novo, é para isso que existe o Aggregate.

Exemplo prático: lista de pedidos de uma API

Este exemplo é nosso, montado só com as opções descritas acima. Os nomes de campo são fictícios. Imagine que o nó HTTP Request chama uma API de uma loja e recebe um único item com estes campos: loja, que guarda o nome da loja, e pedidos, que guarda uma lista de pedidos.

1. Depois do HTTP Request, adicione o Split Out.
2. Em Field to Split Out, digite pedidos.
3. Em Include, escolha Selected Other Fields e, em Fields to Include, digite loja, para o nome da loja acompanhar cada pedido.
4. Execute o nó. Cada pedido da lista vira um item separado.

Agora cada pedido é um item. Nos nós seguintes, você pega o valor de um campo do item com uma expressão no mesmo formato da documentação, por exemplo {{ $json.loja }}.

O que fazer com os itens separados

• Filtrar. Ligue um nó Filter para ficar só com os pedidos que interessam. O guia Filter no n8n: como filtrar itens no seu fluxo mostra como filtrar itens no fluxo.
• Gravar numa planilha. O guia n8n com Google Sheets: como conectar e automatizar planilhas mostra como conectar o n8n ao Google Sheets.
• Avisar por e-mail. O guia Enviar e-mail no n8n: como usar o nó Send Email trata do nó Send Email.

Repare que, sem o Split Out, os nós seguintes receberiam um item só, com a lista inteira dentro de um campo.

Quer conhecer os planos de n8n da Eleven Host? 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 Split Out no n8n?

Serve para pegar um item que tem uma lista dentro de um campo e dividi-lo em vários itens, um por elemento da lista.

Qual campo eu preencho no Split Out?

O Field to Split Out, com o nome do campo que tem a lista a separar.

Como manter os outros campos nos itens separados?

No parâmetro Include, escolha All Other Fields para levar os outros campos, ou Selected Other Fields para levar só os que você indicar em Fields to Include.

Como juntar os itens de volta numa lista?

Use o nó Aggregate, que agrupa itens separados. O Split Out faz a separação, e o Aggregate faz o agrupamento.

O Split Out serve para dados binários?

A documentação prevê esse caso: para dados binários, use $binary numa expressão em Field to Split Out.