Merge no n8n: como juntar dados de vários caminhos

Entenda o nó Merge do n8n, quando usá-lo depois do IF ou do Switch, o que faz cada modo, como cruzar duas listas com Matching Fields e como evitar erros comuns.

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

O Merge no n8n é o nó que junta dados de várias entradas em uma saída só. Segundo a documentação do n8n, ele espera os dados de todas as entradas chegarem antes de seguir, e você escolhe no campo Mode como juntar.

Neste guia você vê quando usar o Merge, o que faz cada modo (Append, Combine, SQL Query e Choose Branch), um exemplo passo a passo que cruza clientes com pagamentos, como o nó espera as entradas e quais erros evitar.

Quando usar o Merge

O IF e o Switch dividem o fluxo em caminhos. O Merge faz o contrário: junta caminhos de volta. Para dividir o fluxo, veja IF no n8n: como criar condições no seu fluxo e em Switch no n8n: como dividir o fluxo em vários caminhos. O Merge é o passo seguinte quando os caminhos precisam voltar para uma linha só.

Ele serve também quando você tem duas fontes de dados e quer cruzar as duas. Um caso: uma lista de clientes de um lado e uma lista de pagamentos do outro, e você quer saber quem pagou. Outro: dois ramos fazem trabalhos diferentes e o próximo nó só deve rodar quando os dois terminarem.

O Merge não repete nada. Para repetir um trabalho em lotes, o nó é outro; veja Loop no n8n: como usar o Loop Over Items no fluxo.

A documentação traz uma nota histórica: na ordem de execução antiga (v0, do n8n 0.236.0 e anteriores), um Merge depois de um IF podia fazer as duas saídas do IF rodarem. Isso foi removido no n8n 1.0.

Os modos do Merge

O campo Mode define o comportamento. Estes são os nomes que aparecem na documentação atual.

Append

Entrega os itens de cada entrada um depois do outro: primeiro os da Entrada 1, depois os da Entrada 2, e assim por diante. Segundo a documentação, o nó espera a execução de todas as entradas conectadas. O campo Number of Inputs permite ligar mais de duas entradas.

Combine

Junta os itens das entradas. O campo Combine By tem três opções:

• Matching Fields: compara os campos que você indicar em Fields to Match, com Input 1 Field e Input 2 Field.
• Position: combina os itens pela ordem. O item 0 da Entrada 1 vai com o item 0 da Entrada 2, e assim por diante. A opção Include Any Unpaired Items escolhe se os itens sem par ficam ou são descartados.
• All Possible Combinations: gera todos os pares possíveis entre os itens das entradas.

No Matching Fields, o campo Output Type define o resultado:

• Keep Matches: junta os itens que combinam, como um inner join.
• Keep Non-Matches: junta os itens que não combinam.
• Keep Everything: junta os que combinam e inclui os que não combinam, como um outer join.
• Enrich Input 1: mantém todos os dados da Entrada 1 e acrescenta os dados que combinam da Entrada 2, como um left join.
• Enrich Input 2: o inverso, como um right join.

SQL Query

Você escreve uma consulta SQL, e as entradas viram tabelas chamadas input1, input2 e assim por diante. Um exemplo da documentação:

SELECT * FROM input1 LEFT JOIN input2 ON input1.name = input2.id

As opções são Query Parameters e Empty Query Result, que pode ser Empty Result (o padrão) ou Success.

Choose Branch

Entrega uma das entradas sem mudar nada. No campo Output, você escolhe Input 1 Data, Input 2 Data ou A Single, Empty Item. Segundo a documentação, essa opção espera os dados das duas entradas. Serve para esperar os dois lados terminarem e seguir com um deles.

Quer conhecer 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

Passo a passo: cruzar clientes e pagamentos

Este exemplo é nosso, montado com as opções da documentação. A Entrada 1 é a lista de clientes do CRM, com o campo email. A Entrada 2 é a lista de pagamentos, com o campo email_pagador. O objetivo é que cada cliente saia com os dados do pagamento, e que quem não pagou continue na lista.

1. Crie dois ramos que entregam dados. Podem ser nós que buscam em uma API (veja HTTP Request no n8n: como chamar uma API no fluxo) ou em um banco de dados.
2. Adicione o nó Merge e ligue o ramo dos clientes na Entrada 1 e o ramo dos pagamentos na Entrada 2.
3. Em Mode, escolha Combine.
4. Em Combine By, escolha Matching Fields.
5. Em Input 1 Field, digite email. Em Input 2 Field, digite email_pagador.
6. Em Output Type, escolha Enrich Input 1. É o comportamento de left join: todos os clientes ficam, com os dados do pagamento quando há correspondência.
7. Execute o nó e confira a saída. Os clientes sem pagamento aparecem sem os dados da Entrada 2.

Nos nós seguintes, você lê os campos da saída com expressões como {{ $json.email }}. Para acessar o campo do pagador, use a mesma forma, por exemplo {{ $json.email_pagador }}.

Opções que ajudam no Combine

• Clash Handling: define o que fazer quando o mesmo campo existe nas duas entradas com valores diferentes. Dentro dele, When Field Values Clash inclui a opção Always Add Input Number to Field Names, e Merging Nested Fields escolhe entre Deep Merge e Shallow Merge.
• Fuzzy Compare e Disable Dot Notation: opções do Combine; leia a descrição de cada uma no nó antes de usar.
• Multiple Matches: escolhe entre Include All Matches e Include First Match Only quando um item combina com mais de um.
• Include Any Unpaired Items: escolhe se os itens sem par são mantidos ou descartados.

Como o Merge espera as entradas

Segundo a documentação, o Merge junta os dados quando os dados de todas as entradas estão disponíveis. Em outras palavras, ele espera. Se um dos ramos não entrega nenhum item, confira esse ramo antes de culpar o Merge.

Se as entradas têm quantidade diferente de itens, a documentação diz que os itens passados na Entrada 1 têm precedência. Por isso, escolha com cuidado qual lista vai em qual entrada.

Quanto ao número de entradas: segundo a documentação, versões anteriores ao n8n 1.49.0 aceitam no máximo duas. Se você precisa de mais, confira a sua versão. No Append, o campo Number of Inputs faz esse ajuste.

Erros comuns com o Merge

• Usar o Merge para repetir trabalho. Ele junta dados; o loop é outro nó.
• Colocar as listas nas entradas trocadas. A Entrada 1 tem precedência quando as quantidades diferem. No Enrich Input 1, a Entrada 1 é a lista que fica inteira.
• Digitar o nome do campo errado em Input 1 Field ou Input 2 Field. Os nomes precisam ser iguais aos que aparecem nos dados de cada entrada, com a mesma grafia.
• Usar Position quando as listas estão em ordens diferentes. A combinação por posição junta o item 0 com o item 0, mesmo que não sejam do mesmo cliente. Para cruzar por e-mail, use Matching Fields.
• Deixar os itens sem par sem querer. Confira Include Any Unpaired Items e o Output Type escolhido para saber se quem não combinou fica ou sai.
• Usar nomes antigos de modo. Nomes como "Merge By Index", "Wait" ou "Multiplex" são de versões antigas e não aparecem na documentação atual.

Veja os planos de 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 Merge no n8n?

Serve para juntar dados de várias entradas em uma saída só, depois que os dados de todas as entradas chegam.

Quais são os modos do Merge?

Append, Combine, SQL Query e Choose Branch, segundo a documentação do n8n.

Como fazer um left join no n8n?

Use o Combine com Matching Fields e escolha Enrich Input 1 em Output Type. Todos os dados da Entrada 1 ficam, com os dados que combinam da Entrada 2.

O Merge aceita mais de duas entradas?

A partir do n8n 1.49.0, segundo a documentação. Versões mais antigas aceitam até duas.