Comment utiliser le noeud Merge dans n8n

Le noeud Merge est l'un des noeuds les plus utilises dans n8n. Il permet de combiner plusieurs branches d'un workflow en une seule sortie. Que ce soit pour fusionner deux listes, comparer des donnees entre sources ou enrichir un jeu de donnees avec des informations complementaires, le Merge intervient dans la majorite des workflows de production.

Ce tutoriel couvre les 5 modes du noeud Merge disponibles dans n8n : Append, SQL Query, Choose Branch, Combine by Matching Fields et Combine by Position. Chaque mode repond a un besoin different, et le choix du bon mode peut simplifier considerablement la logique d'un workflow.

Les 5 modes du noeud Merge

Mode Append - fusionner des branches

Le mode Append est le plus simple. Il prend N branches en entree et les concatene dans une seule branche de sortie. Les items de chaque branche sont empiles les uns a la suite des autres. Cas d'usage typique : deux sources de donnees (API + base de donnees) dont on veut traiter les resultats ensemble dans la suite du workflow.

Mode SQL Query - requetes sur les inputs

Ce mode permet d'executer une requete SQL directement sur les donnees des branches d'entree. On peut faire des SELECT avec JOIN, calculer des differences, renommer des champs et filtrer. Utile pour des comparaisons complexes entre deux jeux de donnees structures, mais rarement utilise en pratique car les autres modes couvrent la majorite des besoins.

Mode Choose Branch - selectionner une branche

Permet de choisir quelle branche d'entree sera transmise en sortie. Avec l'option "Wait for all inputs", le noeud attend que toutes les branches arrivent avant de selectionner celle configuree. Utile dans des workflows conditionnels ou un seul chemin doit etre retenu.

Mode Combine by Matching Fields - comparer et enrichir

Le mode le plus puissant pour travailler avec deux listes. Il compare les items de deux branches sur un champ commun (ex : "nom") et offre 5 options de sortie :

• Keep Matches Only - ne garde que les items presents dans les deux listes (equivalent d'un INNER JOIN)
• Keep Non-Matches - ne garde que les items absents de l'autre liste
• Keep Everything - conserve tous les items avec indication de la source
• Enrich Input 1 - complete les donnees de la branche 1 avec celles de la branche 2
• Enrich Input 2 - complete les donnees de la branche 2 avec celles de la branche 1

L'option "Fields to match have different names" permet de comparer deux champs aux noms differents (ex : "nom" vs "name").

Mode Combine by Position - concatener cote a cote

Ce mode est le plus utilise au quotidien. Il prend deux branches et combine les items par leur position (item 0 + item 0, item 1 + item 1). Le resultat est un seul item contenant toutes les cles des deux branches. Indispensable quand on recupere deux variables dans des branches separees et qu'on veut les reunir pour la suite du workflow.

Options avancees

Option	Description	Quand l'utiliser
Clash Handling	Gere les conflits quand les deux branches ont des champs du meme nom	Combine by Position avec champs identiques
Fuzzy Compare	Compare les valeurs en ignorant le type (string "32" = number 32)	Donnees provenant de sources aux types differents
Disable Dot Notation	Permet d'utiliser des cles contenant des points sans interpretation	Cles JSON avec des points dans le nom
Multi Match	Retourne tous les resultats quand plusieurs items correspondent	Relations one-to-many entre les branches
Include Empty Items	Continue le workflow meme si une branche est vide	Branches optionnelles ou sujettes a erreur

Bonnes pratiques

• Utiliser Append pour simplement empiler des listes
• Utiliser Combine by Position pour reunir deux variables dans un seul item
• Utiliser Combine by Matching Fields pour filtrer, comparer ou enrichir des donnees
• Toujours activer Clash Handling en mode Combine by Position si les champs ont les memes noms
• Activer Include Empty Items si une branche peut etre vide pour eviter que le workflow bloque