Le nœud Merge est l’un des composants les plus puissants de N8N pour gérer des workflows complexes. Il permet de regrouper plusieurs branches d’exécution en une seule sortie, de combiner des données provenant de sources différentes, et de synchroniser des flux parallèles. Que vous ayez besoin de fusionner deux listes, de croiser des données par champ commun, ou d’exécuter des requêtes SQL sur vos flux, le nœud Merge offre cinq modes distincts pour répondre à chaque situation.
Qu’est-ce que le nœud Merge dans N8N ?
Le nœud Merge regroupe plusieurs flux d’entrée en un seul flux de sortie. Dans un workflow N8N, vous pouvez avoir plusieurs branches qui s’exécutent en parallèle : le nœud Merge les rassemble pour permettre un traitement unifié dans la suite du workflow.
Exemple concret : vous récupérez des données depuis deux APIs différentes (clients d’un CRM et commandes d’un e-commerce). Le nœud Merge fusionne ces deux sources pour créer une vue consolidée avant l’envoi dans votre base de données.
Les cinq modes du nœud Merge
Le nœud Merge propose cinq modes de fusion, chacun adapté à un cas d’usage spécifique :
- Append : concatène toutes les entrées en une seule liste
- SQL Query : exécute des requêtes SQL pour joindre et filtrer les données
- Choose Branch : sélectionne une branche spécifique parmi les entrées
- Combine By Matching Fields : fusionne par correspondance de champs
- Combine By Position : fusionne par position dans les listes
Mode Append : regrouper plusieurs listes
Le mode Append est le plus simple et le plus utilisé. Il prend toutes les entrées et les concatène en une seule liste, conservant chaque élément dans l’ordre d’arrivée.
Exemple pratique
Entrée 1 : ["melon", "fraise"]
Entrée 2 : ["fromage blanc", "yaourt"]
Sortie Append : ["melon", "fraise", "fromage blanc", "yaourt"]
Le mode Append conserve le nombre total d’items. Si vous avez 2 items en entrée 1 et 2 items en entrée 2, vous obtenez 4 items en sortie. C’est idéal pour rassembler des données de même structure provenant de sources différentes.
Cas d’usage
- Fusionner des listes de contacts provenant de plusieurs CRM
- Regrouper des produits de différentes catégories avant export
- Consolider des logs de plusieurs services
Mode SQL Query : requêtes avancées sur vos données
Le mode SQL Query transforme vos flux de données en tables virtuelles que vous pouvez interroger avec des requêtes SQL. C’est le mode le plus puissant pour les traitements complexes, mais il nécessite des connaissances en SQL.
Comment ça fonctionne
Chaque entrée du nœud Merge devient une table nommée input1, input2, etc. Vous écrivez ensuite une requête SQL classique pour joindre, filtrer ou transformer ces données.
Exemple : jointure entre deux listes
Entrée 1 (personnes) : [{nom: "Dupont", age: 30}, {nom: "Martin", age: 25}]
Entrée 2 (salaires) : [{nom: "Dupont", salaire: 3000}, {nom: "Martin", salaire: 2500}]
SELECT input1.nom, input1.age, input2.salaire
FROM input1
JOIN input2 ON input1.nom = input2.nomSortie : [{nom: "Dupont", age: 30, salaire: 3000}, {nom: "Martin", age: 25, salaire: 2500}]
Cas d’usage
- Calculer des écarts entre deux listes (ex: différence d’âge, de prix)
- Filtrer des données selon des critères complexes
- Créer des rapports agrégés avec GROUP BY
Mode Choose Branch : sélection conditionnelle
Le mode Choose Branch ne fusionne pas les données : il attend que toutes les entrées soient reçues, puis transmet uniquement les données d’une branche spécifique. C’est utile pour synchroniser des flux parallèles avant de continuer avec une seule source.
Utilisation
Configurez le nœud pour choisir quelle branche transmettre : Input 1, Input 2, ou une sélection basée sur une condition. Le nœud attend que toutes les branches aient terminé leur exécution avant d’agir, garantissant la synchronisation.
Cas d’usage
- Attendre la fin de deux traitements parallèles avant de continuer
- Sélectionner dynamiquement une source de données selon un critère
- Synchroniser des webhooks déclenchés simultanément
Mode Combine By Matching Fields : fusion par champ commun
Ce mode fusionne deux listes en associant les éléments qui partagent une valeur commune sur un champ spécifié. C’est l’équivalent d’un JOIN en SQL, mais sans écrire de requête.
Configuration
Spécifiez le champ de correspondance (ex: « email », « id », « nom »). Le nœud compare les valeurs de ce champ entre les deux entrées et fusionne les éléments correspondants.
Options de sortie
- Keep Matches : conserve uniquement les éléments présents dans les deux listes (INNER JOIN)
- Keep Non-Matches : conserve uniquement les éléments sans correspondance
- Keep Everything : conserve tout, avec enrichissement des correspondances (FULL OUTER JOIN)
- Enrich Input 1 : enrichit la première liste avec les données de la seconde (LEFT JOIN)
Exemple
Entrée 1 : [{nom: "Alice", email: "alice@mail.com"}, {nom: "Bob", email: "bob@mail.com"}]
Entrée 2 : [{email: "alice@mail.com", ville: "Paris"}, {email: "carol@mail.com", ville: "Lyon"}]
Champ de correspondance : « email »
Sortie (Keep Matches) : [{nom: "Alice", email: "alice@mail.com", ville: "Paris"}]
Mode Combine By Position : fusion par index
Ce mode fusionne les éléments selon leur position dans chaque liste. Le premier élément de l’entrée 1 est combiné avec le premier élément de l’entrée 2, et ainsi de suite.
Exemple
Entrée 1 : [{produit: "A"}, {produit: "B"}]
Entrée 2 : [{prix: 10}, {prix: 20}]
Sortie : [{produit: "A", prix: 10}, {produit: "B", prix: 20}]
Gestion des conflits de noms
Si les deux entrées ont des champs portant le même nom, le nœud propose l’option Clash Handling : vous pouvez choisir de garder la valeur de l’entrée 1, de l’entrée 2, ou d’ajouter un suffixe pour distinguer les deux (ex: nom_input1, nom_input2).
Listes de tailles différentes
Si les listes ont des tailles différentes, configurez le comportement : arrêter à la plus courte, compléter avec des valeurs vides, ou ignorer les éléments en surplus.
Options avancées du nœud Merge
Clash Handling
Quand deux entrées ont des champs avec le même nom, Clash Handling permet de définir la priorité ou d’ajouter des suffixes pour éviter l’écrasement de données.
Fuzzy Compare
En mode Combine By Matching Fields, l’option Fuzzy Compare gère les comparaisons entre types différents. Par exemple, le nombre 42 peut correspondre à la chaîne "42" si cette option est activée.
Include Any and Partial
Cette option évite le blocage du workflow si une entrée est vide ou absente. Le nœud continue avec les entrées disponibles au lieu d’attendre indéfiniment.
Tableau récapitulatif des modes
| Mode | Usage principal | Complexité |
| Append | Concaténer plusieurs listes | Simple |
| SQL Query | Requêtes SQL sur les flux | Avancé |
| Choose Branch | Synchroniser et sélectionner | Simple |
| Combine By Matching Fields | Fusion par champ commun | Intermédiaire |
| Combine By Position | Fusion par index | Intermédiaire |
Bonnes pratiques
- Testez avec des données réelles : les cas limites (listes vides, doublons, types mixtes) révèlent souvent des comportements inattendus.
- Activez Include Any and Partial : pour éviter les blocages en cas d’entrée manquante.
- Utilisez Clash Handling : dès que vos entrées ont des champs portant les mêmes noms.
- Préférez Combine By Matching Fields au SQL Query : pour les jointures simples, c’est plus lisible et plus rapide à configurer.
- Documentez vos choix : ajoutez des notes dans le workflow pour expliquer pourquoi vous avez choisi tel mode.
Quel mode du nœud Merge utiliser pour fusionner deux listes en associant les éléments qui partagent un champ commun ?
Conclusion
Le nœud Merge est indispensable pour construire des workflows N8N complexes qui manipulent des données provenant de plusieurs sources. Le mode Append suffit pour la plupart des cas simples, tandis que Combine By Matching Fields et SQL Query offrent des possibilités avancées pour croiser et enrichir vos données.
Pour aller plus loin, explorez nos autres ressources N8N ou contactez notre équipe pour un accompagnement sur vos workflows d’automatisation.
Le nœud Merge permet de regrouper plusieurs flux d’entrée en un seul flux de sortie. Il est utile pour combiner les résultats de différentes branches d’un workflow afin de les traiter ensemble : fusionner des listes, croiser des données par champ commun, ou synchroniser des flux parallèles.
Le mode Append concatène toutes les entrées en une seule liste, conservant chaque élément dans l’ordre d’arrivée. Si vous avez 2 items en entrée 1 et 3 items en entrée 2, vous obtenez 5 items en sortie. C’est idéal pour rassembler des données de même structure provenant de sources différentes.
Le mode SQL Query transforme vos flux de données en tables virtuelles (input1, input2, etc.) que vous pouvez interroger avec des requêtes SQL. Vous pouvez joindre, filtrer et manipuler les données selon des critères précis. C’est un mode avancé qui nécessite des connaissances SQL.
Ce mode fusionne deux listes en associant les éléments qui partagent une valeur commune sur un champ spécifié (email, ID, nom). Il propose des options pour garder uniquement les correspondances (INNER JOIN), les éléments uniques, ou tout fusionner avec enrichissement (FULL OUTER JOIN).
Clash Handling évite les conflits quand deux entrées ont des champs portant le même nom. Vous pouvez choisir quelle valeur garder (entrée 1 ou 2) ou ajouter un suffixe pour distinguer les données (nom_input1, nom_input2). Sans cette option, une valeur peut écraser l’autre silencieusement.
Activez l’option ‘Include Any and Partial’ qui permet de continuer le traitement même si une branche d’entrée est absente ou vide. Le workflow utilise les entrées disponibles sans bloquer. Sans cette option, le nœud attend indéfiniment toutes les entrées.
