Nœud Loop Over Items (Split in Batches) n8nConfigurer Loop Over Items (Split in Batches) dans n8n.

Le motif le plus fréquent tient au débit. Une liste de fiches part vers une API et le service répond mal quand tout arrive d'un coup. Le nœud garde les données d'origine en mémoire et n'en laisse sortir qu'une quantité définie par Batch Size sur la sortie loop à chaque tour : un appel HTTP Request enveloppé dans cette boucle avance par paquets au lieu de saturer l'autre bout, et le même geste vaut pour un dépôt de fichiers en Ftp.

Le deuxième motif, plus délicat, c'est la pagination d'un service dont personne ne connaît le nombre de pages à l'avance. La boucle demande une page, la traite, incrémente le numéro, et un nœud If décide s'il faut repartir pour un tour. L'option Reset est la clé de ce montage : elle fait repartir le nœud du début et traite les données entrantes comme un nouvel ensemble plutôt que comme la suite du précédent. La doc prévient sans détour, et la mise en garde vaut d'être répétée : sans condition de sortie valable, l'exécution part en boucle infinie.

Le troisième motif est une exception de nœud. Certains nœuds ne traitent que le premier item qu'ils reçoivent, et là aucune astuce d'expression ne rattrape le problème. La doc déroule l'exemple de deux flux RSS : un nœud Code émet deux items porteurs d'un champ url, Loop Over Items s'intercale avec Batch Size à 1, et le nœud RSS Feed Read reçoit une adresse après l'autre via l'expression {{ $json.url }}, une expression étant la façon dont un nœud lit un champ de l'item qu'il vient de recevoir.

Hors de ces cas, la réponse est souvent de ne pas s'en servir. Les nœuds n8n sont conçus pour traiter une liste d'items d'entrée : cent lignes passent dans un seul nœud sans la moindre boucle, et une boucle posée autour d'un nœud qui itère déjà ne fait que ralentir le workflow et brouiller la lecture du schéma. Une écriture dans Google Sheets n'a besoin de rien de tout ça.

Quand la boucle est bien là, deux expressions servent à la surveiller. {{$("Loop Over Items").context["noItemsLeft"]}} renvoie un booléen, false tant qu'il reste des données à traiter, true une fois le stock épuisé, et {{$("Loop Over Items").context["currentRunIndex"];}} donne l'index du passage en cours. À la fin, tout ce qui a été traité ressort recombiné sur la sortie done. La Formation n8n reprend cette logique de flux en pratique.