Ressources · Intégration n8n

Nœud Merge n8nConfigurer Merge dans n8n.

Le nœud Merge n8n sert à refermer deux branches d'un workflow en une seule. Il attend que toutes les entrées connectées aient tourné, puis rassemble les items avec un unique paramètre, Mode, et ses 4 options. La version 3 accepte 2 à 10 entrées, des champs à comparer, une requête SQL ou une branche gardée telle quelle.

Tester le nœud Merge sur n8nVoir les 1 paramètres

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud Merge n8n ?

Merge ramène plusieurs branches d'un même workflow dans un seul flux. Il se place après une séparation, après deux recherches, ou après deux chemins qui ont fait un travail différent. Il attend que chaque entrée à laquelle il est relié ait fini, puis sort une seule liste d'items. Un item, c'est une fiche qui circule dans le workflow ; une branche, c'est un des chemins qu'elle peut prendre. Rien à installer, rien à authentifier : le nœud est livré avec n8n.

Le cas le plus courant ressemble à un rapprochement comptable. Une branche va chercher des clients, l'autre lit les commandes dans Google Sheets, et les deux listes doivent n'en faire qu'une. Mode sur combine, Combine By sur Matching Fields, et les noms de champs saisis dans Fields to Match indiquent à n8n quelles valeurs doivent être identiques des deux côtés. Output Type tranche ensuite : Keep Matches pour l'intersection seule, Enrich Input 1 quand la liste clients doit rester complète même là où aucune commande ne correspond.

Deuxième cas, l'empilement pur et simple. Deux chemins produisent chacun des alertes, l'un depuis un formulaire, l'autre depuis un fichier récupéré en Ftp, et tout doit finir dans le même message Slack. Mode sur append sort les items de l'entrée 1, puis ceux de l'entrée 2, dans cet ordre. Number of Inputs monte le nœud jusqu'à 10 points de connexion : trois ou quatre chemins convergent sur un seul nœud au lieu d'une cascade.

Troisième cas, pour qui raisonne déjà en tables. Mode sur combineBySql transforme les entrées en tables nommées input1, input2 et ainsi de suite, et Query contient l'instruction. Une jointure écrite à la main fait en une ligne ce qui prendrait cinq nœuds, et Query Parameters garde les valeurs hors du texte de la requête.

Quand un autre nœud fait mieux le travail : un appel d'API que ne couvre aucun nœud dédié va dans HTTP Request, pas ici, et remodeler un flux unique relève du nœud Code. Merge ne se justifie que si deux flux ou plus doivent s'attendre. Sur une instance ancienne, le nœud Code reste d'ailleurs le repli, puisque SQL Query et les entrées au-delà de deux sont arrivés en 1.49.0.

Restent les limites, à connaître avant le premier test. Les items de l'entrée 1 ont la priorité : cinq items sur l'entrée 1 face à dix sur l'entrée 2, ce sont cinq items traités et le reste abandonné. Fuzzy Compare est désactivé par défaut, donc le texte "3" et le nombre 3 ne sont pas la même valeur tant qu'on ne l'active pas. Et Merge n'ouvre jamais un workflow, un déclencheur passe toujours avant lui. La Formation n8n revient en détail sur ce genre d'assemblage.

Paramètres

Quel paramètre pilote le nœud Merge ?

Le nœud Merge compte un paramètre. Pour chacun : le nœud tel que tu le configures dans n8n, ce que le paramètre change, et nos notes de terrain.

01

Mode

mode

Ce que tu vois dans n8n

Notes & cas d'usage

Mode est le seul paramètre de tête du nœud.

Paramètres clés

  • Mode : append empile les items, combine fusionne les correspondances ; combineBySql exécute une requête, chooseBranch laisse passer une branche.
  • Number of Inputs : 2 à 10 points de connexion.
  • Combine By : Matching Fields, Position ou All Possible Combinations.
  • Fields to Match : id, name, plus Fields To Match Have Different Names si besoin.
  • Output Type : Keep Matches, Keep Non-Matches, Keep Everything, Enrich Input 1, Enrich Input 2.
  • Query : requis en SQL Query ; entrées et tables input1, input2.
  • Output et Use Data of Input : Choose Branch sort une entrée ou un item vide.
Cas d'usage
enrichir une liste clients avec les commandes d'une autre branche. Output Data From ne sort que l'entrée 1.
Besoin d'aide

Besoin d'aide pour automatiser Merge avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions qui reviennent sur Merge

01Le nœud Merge n8n est-il gratuit sur le cloud et en auto-hébergé ?
Oui. Merge est un nœud core livré avec n8n, il est donc présent dès la création d'un workflow. Rien à installer, aucun magasin de nœuds à visiter, aucun surcoût côté n8n. Le comportement est le même sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée installée avec Docker ou npm, en Community Edition sous licence Sustainable Use. Un workflow construit d'un côté tourne de l'autre sans retouche. Seule la version du nœud peut changer d'une instance à l'autre : un workflow créé il y a longtemps peut afficher un Merge plus ancien, avec moins d'options, et un nœud ne change jamais de version tout seul.
02Quels identifiants faut-il pour le nœud Merge ?
Aucun, et c'est vite réglé. Merge n'a ni credential, l'objet qui stocke les accès d'un service dans n8n, ni sélecteur Authentication, parce qu'il n'appelle aucun service extérieur. Il travaille uniquement sur les items qui circulent déjà dans le workflow. Rien à configurer côté compte, aucune clé à renouveler. Ce dont il a besoin, c'est d'un câblage correct : au moins deux branches reliées à ses entrées, et un déclencheur quelque part en amont, puisque Merge n'ouvre pas un workflow. Si les branches attendues ne tournent pas, le nœud ne part pas non plus. Tout le reste se joue dans Mode et les champs qui apparaissent une fois le mode choisi.
03Quelles sont les limites du nœud Merge ?
Trois comptent vraiment. L'entrée 1 a la priorité quand les flux n'ont pas le même nombre d'items : cinq items sur l'entrée 1 contre dix sur l'entrée 2, ce sont cinq items traités, les cinq restants ne le sont pas. Les différences de type sont traitées comme de vraies différences tant que Fuzzy Compare n'est pas ajouté, donc une valeur stockée en texte et la même valeur stockée en nombre ne se rejoignent pas. Enfin, les paramètres disponibles dépendent de la version : au-delà de deux entrées, et le mode SQL Query, sont arrivés plus tard. Merge rassemble des données, il ne les transforme pas et n'appelle aucune API.
04Merge ou le nœud Code pour fusionner deux flux ?
Merge dès que deux branches ou plus doivent s'attendre avant la suite. Cette attente est la vraie valeur du nœud : il retient l'exécution jusqu'à ce que chaque entrée connectée soit passée, et la jointure tient dans une liste déroulante de quatre options au lieu d'un script à maintenir. Le nœud Code reprend la main quand un flux unique doit être remodelé, quand la logique de rapprochement dépend de conditions qu'aucun mode ne couvre, ou quand l'instance est trop ancienne pour SQL Query et pour plus de deux entrées. Règle simple : si l'opération se décrit par empiler, comparer, interroger ou garder une branche, Merge la fait sans une ligne de code.
05n8n ou Make pour rapprocher deux sources de données ?
Ça dépend de trois critères, et le prix n'est que l'un d'eux. Make tourne sur sa propre plateforme hébergée, sans option d'auto-hébergement, et facture à l'opération : un workflow qui fusionne de grandes listes item par item devient une question de volume. n8n tourne sur n8n Cloud ou sur un serveur que tu contrôles, ce qui compte quand les données rapprochées sont des données clients ou financières qui ne doivent pas sortir de ton infrastructure. Le troisième critère, c'est ta façon de penser la jointure. Merge l'expose en modes, en champs à comparer et même en SQL. Les deux outils dessinent les workflows visuellement, le canevas tranche rarement.
Hack'celeration Lab

Reçois nos tips intégration chaque semaine.

Pas de spam. Désinscription à tout moment.

Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations