Comment utiliser le nœud Merge dans n8n

Le nœud Merge est l'un des nœuds les plus utilisés dans n8n. Il permet de combiner plusieurs branches d'un workflow en une seule sortie. Que ce soit pour fusionner deux listes, comparer des données entre sources ou enrichir un jeu de données avec des informations complémentaires, le Merge intervient dans la majorité des workflows de production.

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

Les 5 modes du nœud Merge

Mode Append - fusionner des branches

Le mode Append est le plus simple. Il prend N branches en entree et les concatène dans une seule branche de sortie. Les items de chaque branche sont empilés les uns à la suite des autres. Cas d'usage typique : deux sources de données (API + base de données) dont on veut traiter les résultats ensemble dans la suite du workflow.

Mode SQL Query - requêtes sur les inputs

Ce mode permet d'exécuter une requête SQL directement sur les données des branches d'entree. On peut faire des SELECT avec JOIN, calculer des différences, renommer des champs et filtrer. Utile pour des comparaisons complexes entre deux jeux de données structures, mais rarement utilise en pratique car les autres modes couvrent la majorité des besoins.

Mode Choose Branch - sélectionner une branche

Permet de choisir quelle branche d'entree sera transmise en sortie. Avec l'option "Wait for all inputs", le nœud attend que toutes les branches arrivent avant de sélectionner celle configurée. Utile dans des workflows conditionnels ou un seul chemin doit être 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 - complète les données de la branche 1 avec celles de la branche 2
• Enrich Input 2 - complète les données 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 différents (ex : "nom" vs "name").

Mode Combine by Position - concatèner côté à côté

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 résultat est un seul item contenant toutes les clés des deux branches. Indispensable quand on récupère deux variables dans des branches séparées et qu'on veut les reunir pour la suite du workflow.

Options avancées

Option	Description	Quand l'utiliser
Clash Handling	Gere les conflits quand les deux branches ont des champs du même 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 différents
Disable Dot Notation	Permet d'utiliser des clés contenant des points sans interpretation	Cles JSON avec des points dans le nom
Multi Match	Retourne tous les résultats quand plusieurs items correspondent	Relations one-to-many entre les branches
Include Empty Items	Continue le workflow même si une branche est vide	Branches optionnelles ou sujettes à 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 données
• Toujours activer Clash Handling en mode Combine by Position si les champs ont les memes noms
• Activer Include Empty Items si une branche peut être vide pour eviter que le workflow bloque