Recursos · Integración n8n

Nodo Loop Over Items (Split in Batches) n8nConfigura Loop Over Items (Split in Batches) en n8n.

Casi todos los nodos de n8n ya procesan una lista de items por su cuenta. El nodo Loop Over Items (Split in Batches) n8n hace falta cuando eso falla: devuelve un número fijo de items por pasada en la salida loop y al final lo suelta todo por done. Dos parámetros, versión 3.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve el nodo Loop Over Items (Split in Batches) n8n?

Loop Over Items marca el ritmo de un lote. Retiene en memoria los datos entrantes originales, suelta en cada vuelta una cantidad definida de items por la salida loop y, terminada la ejecución, junta todo lo procesado y lo entrega por la salida done. Su nombre dentro de un archivo de flujo de trabajo, n8n-nodes-base.splitInBatches, describe la mecánica mejor que su etiqueta.

El caso que no admite alternativa es una excepción de nodo: hay nodos que solo procesan el primer item que reciben, y ninguna expresión arregla eso. La documentación lo enseña con dos fuentes RSS: un nodo Code emite dos items con un campo url, Loop Over Items se intercala con Batch Size en 1 y el nodo RSS Feed Read va recibiendo una dirección detrás de otra con la expresión {{ $json.url }}, siendo una expresión la forma en que un nodo lee un campo del item que acaba de recibir.

Conviene entender qué sale por dónde antes de montarlo. En cada vuelta, la salida loop entrega la cantidad de items fijada en Batch Size, y esa rama es la que lleva el trabajo de verdad. Cuando ya no queda nada por procesar, el nodo combina todo lo tratado y lo devuelve por la salida done, que es donde se engancha el paso final: un resumen que acaba en Slack, por ejemplo.

El segundo uso es la paginación contra un servicio cuyo número de páginas nadie conoce por adelantado. El bucle pide una página, la procesa, incrementa el número y un nodo If decide si toca otra vuelta. La opción Reset sostiene ese montaje: hace que el nodo empiece de nuevo desde el principio y trate los datos entrantes como un conjunto nuevo en lugar de como continuación de los anteriores. Y la advertencia de la documentación es literal: sin una condición de salida válida, la ejecución se queda atrapada en un bucle infinito.

El tercer uso son los límites de peticiones. Repartir las llamadas en lotes evita disparar todo de golpe contra un servicio que no lo tolera, ya sea una llamada HTTP Request o una tanda de envíos con Gmail. El ritmo lo marca un solo número, y ajustarlo es casi toda la configuración del nodo.

Queda la pregunta que ahorra trabajo: muchas veces no hace falta. Los nodos de n8n ya están pensados para procesar una lista de items de entrada, así que cien filas atraviesan un solo nodo sin ningún bucle, y envolver en un bucle algo que ya itera solo añade lentitud y un diagrama más difícil de leer. Para vigilar las vueltas cuando el bucle sí está justificado, {{$("Loop Over Items").context["noItemsLeft"]}} devuelve un booleano, false mientras queden datos y true cuando ya no quedan, y {{$("Loop Over Items").context["currentRunIndex"];}} da el índice de la pasada actual. El Curso n8n trabaja esta lógica de flujo con las manos.

Parámetros

¿Qué parámetros ofrece Loop Over Items?

El nodo Loop Over Items (Split in Batches) tiene 2 parámetros. Para cada uno: el nodo tal como lo configuras en n8n, qué cambia el parámetro y nuestras notas de campo.

01

Batch Size

batchSize

Lo que ves en n8n

Notas y casos de uso

Fija el número de items que se devuelven en cada llamada. Esa cifra manda sobre cuántos datos salen por iteración en la salida loop y, de paso, sobre cuántas iteraciones hará el nodo en total.

Parámetros clave

  • Batch Size: un campo numérico que se escribe en el panel. Con 1, la rama de abajo ve un único item por pasada, que es justo lo que hace el ejemplo RSS para que el nodo lector reciba una dirección de fuente cada vez.
Casos de uso
alimentar un nodo que solo procesa el primer item recibido, o trocear una lista larga en llamadas lo bastante pequeñas para una API que limita el ritmo.
02

Options

options

Lo que ves en n8n

Notas y casos de uso

Una colección que se abre con Add option. Mientras no añadas una opción, esta conserva su valor por defecto y ni siquiera aparece en el panel. Este nodo ofrece una sola.

Parámetros clave

  • Reset: un booleano. Activado, el nodo vuelve a empezar desde el principio de los items de entrada y trata los datos entrantes como un conjunto nuevo en lugar de la continuación de los items anteriores. Si cambias el parámetro de Fixed a Expression, el resultado de esa expresión decide cuándo ocurre el reinicio.
Casos de uso
consultar un servicio paginado página a página con un nodo If que sostiene la condición de salida, siempre que esa condición pueda cumplirse de verdad.
Necesitas ayuda

¿Necesitas ayuda para automatizar Loop Over Items (Split in Batches) con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Loop Over Items, preguntas habituales

01¿El nodo Loop Over Items viene incluido en n8n?
Sí. Es un nodo core que se entrega con n8n: nada que instalar y ningún coste extra por parte de n8n. Funciona igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada instalada con Docker o npm, en Community Edition con licencia Sustainable Use. Un flujo de trabajo montado en un sitio corre idéntico en el otro, así que un bucle probado en local se lleva a Cloud sin tocar nada. En el panel el nodo aparece en la categoría Core Nodes, junto a los demás nodos de lógica de flujo.
02¿Qué hay que configurar antes de usarlo?
Nada del lado de la cuenta. Este nodo no tiene credential, es decir un juego de credenciales guardado en n8n, ni selector Authentication. No hay clave que pegar, ni permiso que conceder, ni conexión que aprobar. Lo que sí necesita son datos delante. Loop Over Items no abre un flujo de trabajo por sí mismo: antes va un disparador, un Schedule Trigger, un Webhook o el trigger de la herramienta de la que sacas los datos. A partir de ahí, las únicas decisiones son el tamaño del lote y si la opción Reset pinta algo en tu bucle.
03¿Qué límites tiene el nodo Loop Over Items (Split in Batches) n8n?
El nodo expone dos parámetros, Batch Size y la colección Options con su única opción Reset. Ahí acaba toda la superficie. No trae ninguna condición de parada incorporada, así que un bucle que reprocesa su entrada exige una condición de salida tuya, normalmente un nodo If, o la ejecución no termina nunca. Esta página describe la versión 3, la más alta del catálogo. Un flujo antiguo puede mostrar una versión anterior con menos opciones, y un nodo no cambia de versión solo: mira la versión del panel antes de buscar un ajuste que no está.
04¿Cuándo conviene añadir este nodo en vez de dejar que n8n itere solo?
Solo cuando el comportamiento por defecto se atasca. Los nodos de n8n están hechos para procesar una lista de items de entrada, así que casi siempre los items pasan sin ayuda y meter un bucle únicamente ralentiza el flujo de trabajo. Tres situaciones lo justifican. Un nodo que solo procesa el primer item recibido, como el RSS Feed Read del ejemplo documentado. Una API que limita el ritmo, donde trocear las llamadas las reparte en el tiempo. Y una paginación con un número de páginas desconocido, que es el caso para el que existe la opción Reset.
05¿n8n o Make para iterar sobre una lista?
Las dos lo hacen, y la decisión rara vez se juega en el bucle. Make es una plataforma de automatización alojada, sin opción de autoalojamiento, facturada por operación: un bucle con muchas iteraciones pequeñas se convierte en una línea de coste previsible pero inevitable. n8n corre en Cloud o en tus propios servidores, algo que cuenta cuando los datos que atraviesan los lotes no pueden salir de tu infraestructura, y su modelo de precio no se cuenta por iteración. Decide por alojamiento, control de los datos, coste y qué lógica visual lees más rápido.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.