Ressources · Intégration n8n

Nœud Split Out n8nConfigurer Split Out dans n8n.

Un item qui contient une liste reste un item, et la suite du workflow ne tourne qu'une fois. Le nœud Split Out n8n casse cette liste en items séparés, un par entrée. Trois paramètres suffisent : le champ à découper, ce qu'on garde autour, et une courte liste d'options.

Tester le nœud Split Out sur n8nVoir les 3 paramètres

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

Pourquoi automatiser

À quoi sert le nœud Split Out n8n ?

Split Out prend un item entrant qui contient une liste et transforme cette liste en items séparés, un par entrée. Sa description tient en une ligne : transformer une liste présente dans un item en items distincts. Rien d'autre ne bouge. Le nœud s'exécute sur chaque item entrant et n'ouvre jamais un workflow tout seul : un déclencheur le précède, un Schedule Trigger, un Webhook ou le trigger d'un outil.

Premier cas de figure, celui du contexte perdu. Les entrées de la liste sont pauvres et l'information utile vit à côté d'elles, sur l'item parent. Une ligne de commande porte un nom de produit, l'adresse du client est ailleurs. Le paramètre Include décide de ce qui accompagne chaque nouvel item, et Selected Other Fields permet de n'emporter que les deux ou trois clés qui serviront vraiment, par exemple avant d'envoyer un message par Gmail.

Deuxième cas de figure : la liste est imbriquée. Elle n'est pas à la racine de l'item mais sous une clé parente. La notation pointée est active par défaut, donc data.items est un nom de champ valable tel quel. Quand les clés contiennent elles-mêmes des points, l'option Disable Dot Notation existe précisément pour ça.

Troisième cas de figure, le plus courant : le compte d'items. Tant que la liste dort dans un item unique, le nœud suivant ne s'exécute qu'une fois. Une fois Fields To Split Out renseigné, chaque entrée devient un item, et un test If placé derrière évalue chaque entrée séparément au lieu du paquet entier.

Quand vaut-il mieux un autre nœud ? Si rien n'a besoin de devenir un item distinct, et qu'il s'agit seulement de renommer, restructurer ou ajouter des clés, Edit Fields (Set) fait le travail. Split Out sert au moment où le nombre d'items doit changer.

Côté limites, autant les connaître avant de construire. Le nœud est en version 1 et s'arrête à trois paramètres. Fields To Split Out est requis : laissé vide, il bloque l'exécution. Les données binaires suivent leur propre chemin, l'aide du panneau indique d'utiliser $binary pour découper l'item entrant par donnée binaire, et Include Binary commande leur présence dans les nouveaux items. Pour situer la plateforme, l'Avis n8n creuse le sujet, et la Formation n8n passe par ce type de nœud.

Paramètres

Quels paramètres propose Split Out ?

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

01

Fields To Split Out

fieldToSplitOut

Ce que tu vois dans n8n

Notes & cas d'usage

Le nœud apprend ici quelle clé porte la liste. Une fois le champ renseigné, chaque entrée de cette liste ressort comme un item à part entière. Vide, il bloque, parce que ce champ est requis.

Paramètres clés

  • Fields To Split Out : le nom des champs d'entrée à éclater en items séparés, séparés par des virgules quand il y en a plusieurs. Le panneau propose de glisser les champs depuis la gauche ou d'écrire leur nom, et une expression comme {{ $json.orders }} fonctionne aussi. Pour les données binaires, utilise $binary.
Cas d'usage
un item qui transporte une liste de participants devient un item par participant, prêt pour une action individuelle.
02

Include

include

Ce que tu vois dans n8n

Notes & cas d'usage

Par défaut, découper une liste laisse le reste de l'item de côté. Ce sélecteur répond à la question inverse : faut-il recopier les autres champs dans les nouveaux items ?

Paramètres clés

  • No Other Fields : aucun autre champ n'est inclus, chaque item ne garde que le contenu de l'entrée.
  • All Other Fields : tous les autres champs sont inclus sur chaque nouvel item.
  • Selected Other Fields : seuls les champs sélectionnés sont inclus.
  • Fields To Include : apparaît avec le choix précédent, une liste de champs séparés par des virgules, du type email, name.
Cas d'usage
conserver l'identifiant de la commande sur chaque ligne découpée, pour retrouver à quoi elle appartient plus loin.
03

Options

options

Ce que tu vois dans n8n

Notes & cas d'usage

Trois réglages attendent derrière « Add option », et chacun répond à un problème qui n'apparaît qu'avec de vraies données. Une option non ajoutée garde sa valeur par défaut.

Paramètres clés

  • Disable Dot Notation : interdit de référencer un champ enfant sous la forme parent.child dans le nom du champ. Utile quand les clés contiennent des points.
  • Destination Field Name : le champ de sortie sous lequel placer le contenu découpé.
  • Include Binary : indique s'il faut inclure les données binaires de l'entrée dans les nouveaux items.
Cas d'usage
choisir un nom de champ de destination pour que le contenu arrive sous la clé qu'attend déjà le nœud suivant.
Besoin d'aide

Besoin d'aide pour automatiser Split Out avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Les questions fréquentes sur Split Out

01Le nœud Split Out n8n est-il gratuit sur Cloud et en auto-hébergé ?
Oui. Split Out fait partie des nœuds core livrés avec n8n : rien à installer, aucun surcoût côté n8n. Il se comporte de la même façon sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée avec Docker ou npm en Community Edition, sous licence Sustainable Use. Un workflow construit d'un côté tourne à l'identique de l'autre, ce qui compte quand un prototype démarre sur Cloud avant de partir sur un serveur maison. Le nœud n'ajoute ni quota ni facturation à l'item.
02Faut-il un credential pour utiliser Split Out ?
Non, il n'y a rien à authentifier. Le nœud n'a ni credential, c'est-à-dire aucun identifiant enregistré dans n8n, ni sélecteur Authentication. Aucun compte à relier, aucune clé à stocker. Une fois posé sur la toile, la seule chose dont il a besoin, ce sont des données qui arrivent sur son entrée. Elles viennent forcément d'ailleurs, puisque le nœud n'ouvre pas un workflow : un Schedule Trigger, un Webhook ou le trigger d'un outil le précède, et Split Out s'exécute sur chaque item entrant. Toute la configuration tient dans les trois paramètres du panneau.
03Quelles sont les limites du nœud Split Out ?
Il fait une seule chose. Le nœud lit un champ qui contient une liste et transforme ses entrées en items séparés, c'est tout le contrat annoncé par sa description. Trois paramètres, version 1 : au-delà, le nœud ne répond pas. Le champ Fields To Split Out est requis, une valeur vide bloque l'exécution au lieu de laisser passer les données. Et si un workflow hérité affiche moins d'options que cette page, c'est qu'il utilise une version antérieure du nœud, sachant qu'un nœud ne change jamais de version tout seul.
04Quand découper une liste plutôt que la laisser dans un item ?
La règle tient au nombre d'exécutions. Un nœud placé après Split Out voit chaque entrée comme un item, donc il s'exécute une fois par entrée au lieu d'une fois pour toute la liste. La liste reste entière quand l'étape suivante doit la voir d'un bloc, ou quand il s'agit seulement de renommer et réorganiser des clés, un travail qui revient à Edit Fields (Set) et pas à un changement du nombre d'items. La vraie question n'est jamais la donnée, c'est le nombre de fois où la suite doit tourner.
05n8n ou Make pour découper une liste en items ?
Ça dépend de ce qui compte le plus. Make, ex-Integromat, est une plateforme d'automatisation hébergée, sans option d'auto-hébergement, facturée à l'opération : simple à démarrer, facile à prévoir sur de petits volumes. n8n s'auto-héberge avec Docker ou npm, donc les données restent sur une infrastructure maîtrisée, et l'offre hébergée existe aussi pour éviter la gestion de serveur. Découper une liste multiplie les étapes en aval, alors le modèle de coût mérite un calcul avant de trancher. Sur un workflow qui découpe beaucoup de listes, l'écart se creuse vite, et la réponse dépend surtout du volume traité chaque mois.
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