Il nodo Split Out in n8n: come processare liste di elementi uno per uno

Hai mai ricevuto una risposta API con un array di risultati e ti sei chiesto come lavorare su ogni elemento singolarmente senza scrivere codice? Il nodo split out n8n è la scorciatoia elegante per trasformare una lista in tanti item indipendenti, perfetti per azioni di marketing come arricchimento lead, pubblicazioni programmate o sincronizzazioni multi‑canale. In questa guida operativa, pensata per marketer che vogliono migliorare la produttività, scoprirai come configurare il nodo, quali sono i parametri chiave, come evitare gli errori più comuni e come integrarlo con nodi di trasformazione e unione per chiudere il loop dei tuoi flussi. Vedrai esempi pratici per elaborare array JSON in n8n provenienti da API, fogli e piattaforme eCommerce, oltre a un confronto chiaro tra Split Out e Loop Over Items. Ti mostrerò anche come usare opzioni come Disable Dot Notation, Destination Field Name e Include Binary, così da gestire campi annidati e payload pesanti in sicurezza. Alla fine, avrai un set di playbook pronti da copiare per iterare elementi in un workflow n8n e scalare le tue automazioni senza complessità.

📚 Nuovo a n8n? Parti dalla guida completa: cos’è n8n e come funziona.

[IMG: Vista canvas di un workflow n8n che usa HTTP Request → Split Out → Filter → Aggregate]

Cos’è il nodo Split Out e perché è cruciale per i marketer

Il nodo Split Out separa un singolo item che contiene una lista in più item, uno per ogni elemento dell’array. Obiettivo del nodo: trasformare una lista/array in elementi singoli in modo dichiarativo, senza scrivere codice. Questo significa che se una chiamata API ritorna { results: […] }, puoi trasformare “results” in tanti item indipendenti, ognuno processabile con nodi downstream (es. invio email, creazione task, posting social).

Vantaggi pratici rispetto ad approcci manuali:

Riduce la complessità dei loop: invece di gestire codice o funzioni custom, definisci semplicemente il Field to Split Out e lasci che n8n emetta gli item.
Flessibilità dei dati: puoi scegliere cosa mantenere dall’item originale (nessun campo, tutti i campi, o un sottoinsieme selezionato) grazie a Include.
Compatibilità con pattern post‑split: dopo aver trasformato elenco in item singoli, puoi filtrare, arricchire dati e poi unire risultati dopo la suddivisione (Merge Items) usando Aggregate o il Merge node.

Perché è utile a chi fa marketing:

Processare risultati API in n8n per campagne (es. lista prodotti, offerte, nuove issue GitHub).
Esempi di workflow n8n con liste da Google Sheets o CRM per messaggi personalizzati, segmentazioni e orchestrazioni cross‑channel.
Best practice per loop su liste in n8n che semplificano l’operatività e abilitano scalabilità.

Insight unico: se combini Split Out con un nodo Filter e poi Aggregate, ottieni un “filtro avanzato su array” che si integra naturalmente con tool esterni (CRM, Ads, social), ottimizzando campagne guidate da dataset complessi.

[IMG: Output del nodo Split Out con item singoli derivati da un array “results”]

Parametri del nodo di suddivisione in n8n: configurazione completa

Il nodo Split Out ha parametri chiave che definiscono cosa suddividere e come strutturare l’output.

Field to Split Out
Inserisci il campo che contiene la lista da separare. Esempio: results, data.items, customers.list.
Se lavori con input binari, puoi usare $binary in un’espressione per impostare il campo da suddividere.
Include
Determina se e come n8n conserva altri campi dell’item di input in ogni nuovo item.
Opzioni:
- No Other Fields: non include nessun altro campo.
- All Other Fields: include tutti i campi extra.
- Selected Other Fields: include solo i campi selezionati.
- Fields to Include: inserisci una lista separata da virgole dei campi da includere (es. id, source, campaign).
Node options
Disable Dot Notation
- Di default n8n abilita la dot notation (parent.child). Questa opzione ti permette di disabilitare la dot notation (ON) o mantenerla (OFF). Utile quando i nomi dei campi contengono punti letterali o quando vuoi evitare collisioni.
Destination Field Name
- Inserisci il campo dell’output in cui salvare il contenuto estratto. Consigliato per preservare il payload originale e per naming coerente (es. item estratto in dataItem).
Include Binary
- Includi o meno i dati binari dall’input nei nuovi item. Importante per gestione dati binari in automazioni n8n come allegati o immagini.

Linee guida rapide:

Parametri del nodo di suddivisione in n8n devono riflettere la struttura reale dei dati: valida sempre il percorso in Field to Split Out.
Usa Destination Field Name quando vuoi isolare l’elemento estratto e mantenere metadati separati.

[IMG: Configurazione del nodo Split Out con Field to Split Out=results, Include=Selected Other Fields, Fields to Include=id,source]

Keyword integrate: inclusione campi nel nodo di suddivisione, dot notation in n8n, campo di destinazione per l’elemento estratto.

Esempi pratici: processare risultati API in n8n (step‑by‑step)

Caso d’uso: vuoi lavorare su ogni risultato della PokéAPI come item separato.

Step‑by‑step

HTTP Request

Authentication: None
Request Method: GET
URL: https://pokeapi.co/api/v2/pokemon
Esegui il nodo e visualizza l’output: troverai un array results.

Split Out

Field to Split Out: results
Include: No Other Fields (oppure All/Selected a seconda dei tuoi metadati)
Esegui il nodo: vedrai più item, uno per ogni elemento dell’array.

Filtra e trasforma

Aggiungi un nodo IF o Filter per selezionare item specifici (es. nome che inizia per “pi”).
Applica trasformazioni con Set/Aggregate o arricchisci con nuove chiamate API.

Unisci/report

Se devi ricomporre i risultati, usa Aggregate per “group by” o comporre un array unico; in alternativa, usa il Merge node per unire stream differenti.

Snippet di trasformazione in Code (alternativa al nodo)

// Esempio educativo: alternativa manuale al nodo Split Out
let items = $input.all();
return items[0].json.results.map(r => ({ json: r }));

Best practice:

Elaborare array JSON in n8n con Split Out evita codice e rende i flussi leggibili per il team.
Trasformare elenco in item singoli è ideale quando vuoi attivare azioni per ogni elemento (es. creare post, inviare messaggi personalizzati, creare ticket).

[IMG: Esecuzione del nodo HTTP Request con body contenente results; poi Split Out con output multi‑item]

Keyword integrate: processare risultati API in n8n, esempi di workflow n8n con liste.

Split Out vs Loop Over Items (Split In Batches): cosa cambia davvero

Confronto Split Out e Loop Over Items:

Split Out
Scopo: partendo da un singolo item che contiene un array, emette N item (uno per elemento).
Vantaggio: riduce la necessità di codice; perfetto per array annidati in una proprietà specifica (Field to Split Out).
Output: struttura dell’item in uscita focalizzata sull’elemento estratto, con opzioni di Include per mantenere metadati.
Loop Over Items (UI per Split In Batches)
Scopo: iterare su item già esistenti, potenzialmente in batch controllati (batchSize) con “Execute Next Batch”.
Vantaggio: controllo di flusso, ripetizioni controllate e gestione carichi (utile con API rate‑limited).
Output: stessa forma di item, processati a gruppi. Fornisce percorso “No Items” quando la coda è esaurita.

Quando preferire l’uno o l’altro:

Usa il nodo split out n8n quando devi “spacchettare” un array presente all’interno di un singolo item (es. results di un’API).
Usa Loop Over Items quando hai già più item e vuoi controllare ritmo e batching (es. 1000 record da processare a blocchi da 50).

Insight operativo:

Spesso conviene combinare i due: Split Out per trasformare l’array in N item, poi Loop Over Items per processarli in batch e rispettare quote o limiti API.

Keyword integrate: confronto Split Out e Loop Over Items, best practice per loop su liste in n8n.

[IMG: Diagramma differenze: a sinistra Split Out da 1→N; a destra Loop Over Items che processa N item in batch]

Pattern post‑Split: trasformazioni, filtri e unione (Aggregate/Merge)

Dopo Split Out, hai item atomici: ora puoi applicare:

Trasformazioni
Set per rinominare campi o mappare strutture.
Code per logiche su misura quando necessario.
Filtri
IF/Filter per segmentazioni (es. prezzo > X, status = active).
Arricchimenti
HTTP Request verso CRM/DB per ulteriore contesto.

Unire risultati dopo la suddivisione (Merge Items):

Aggregate node
Crea un singolo item a partire da più item (es. raccogli tutti i risultati in un array “data”).
Esempio: dopo filtri e trasformazioni, esegui Aggregate per produrre un report compatto.
Merge node
Unisce due stream di item. Modalità comuni: Append, Merge By Key, Merge By Index, Wait.
Caso tipico: Split Out (prodotti) + arricchimento prezzi da altra fonte → Merge By Key su productId per ricomporre le informazioni.

Esempio breve con Aggregate

// Obiettivo: ricomporre un array 'data' con tutti gli item correnti
return [
  { json: { data: $input.all().map(i => i.json) } }
];

Buone pratiche:

Merging e propagazione dei metadati: decidi se includere i campi originali (Include) prima dello split per evitare di perderli o dover re‑joinare in seguito.
Impatto su campi multipli e nested: definisci naming coerente (Destination Field Name) per evitare ambiguità.

[IMG: Catena Split Out → Filter → Enrich (HTTP) → Merge By Key → Aggregate in report finale]

Dot notation, Destination Field Name e binary: come evitare insidie

Dot notation in n8n:

Di default puoi referenziare child fields con parent.child. Con campi annidati è comoda per Field to Split Out (es. data.items).
Quando disattivarla:
Se i nomi dei campi contengono punti letterali (es. “price.usd”), abilita Disable Dot Notation per trattare il nome come stringa intera e prevenire collisioni o risoluzioni errate.

Destination Field Name:

Serve a scegliere dove mettere l’elemento estratto nell’output. Esempio: Destination Field Name = dataItem.
Vantaggio: preservi l’item originale e isoli l’elemento “spacchettato” in un campo dedicato, rendendo più chiara la logica a valle.

Include Binary:

Se ON, i dati nel $binary dell’input vengono copiati nei nuovi item. Utile per workflow con immagini/allegati, ma attenzione ai payload pesanti.
Suggerimenti:
Valuta la dimensione e l’impatto sulle prestazioni.
Se non serve il binario nei passaggi successivi, lascialo OFF per snellire l’elaborazione.

Esempio di uso con $binary (Field to Split Out in espressione):

Se devi suddividere una lista presente nei metadati di un file binario, imposta Field to Split Out tramite espressione che punti a $binary e al relativo campo custom.

Keyword integrate: dot notation in n8n, gestione dati binari in automazioni n8n.

[IMG: Pannello Node options con Disable Dot Notation ON, Destination Field Name impostato e Include Binary OFF]

Best practice per loop su liste in n8n e performance

Validazioni pre‑nodo
Verifica che Field to Split Out punti davvero a un array. Usa IF per controllare Array.isArray(…) via espressione/Code prima di Split Out.
Naming coerente
Scegli un Destination Field Name consistente (es. item, row, dataItem) e mantienilo nel workflow per chiarezza.
Gestione campi pesanti
Seleziona Include = Selected Other Fields e specifica solo i metadati necessari (Fields to Include). Evita di propagare campi enormi inutilmente.
Monitoraggio/error‑handling
Aggiungi rami “errore” con notifiche (Slack/Email) quando l’array è vuoto o non standard.
Batching intelligente
Se dopo lo split devi chiamare API rate‑limited, passa i risultati al Loop Over Items (Split In Batches) per batch controllati.
Documentazione
Inserisci sticky notes sul canvas per spiegare la scelta dei parametri del nodo di suddivisione in n8n e le assunzioni sui dati.

[IMG: IF pre‑Split Out che controlla la presenza e lunghezza di results; ramo di errore verso notifica Slack]

Troubleshooting: array e campi annidati, errori comuni e soluzioni

Errori comuni e come risolverli:

Array vuoti o non standard
Sintomo: Split Out non emette item.
Soluzione: verifica la risposta dell’API; controlla che Field to Split Out punti a un array esistente (es. results vs data.results). Aggiungi un nodo IF per fallback.
Percorsi errati
Sintomo: 0 item in output.
Soluzione: usa l’Expression Editor per navigare l’anteprima dati e confermare il path. Considera Disable Dot Notation se i nomi dei campi includono punti.
Dot notation inattesa
Sintomo: campi non risolti correttamente.
Soluzione: attiva Disable Dot Notation nelle Node options e usa il nome campo letterale.
Duplicazioni di campi
Sintomo: conflitti tra campo estratto e metadati originali.
Soluzione: definisci Destination Field Name diverso dal nome originale; usa Include = Selected per controllare i metadati.
Binary troppo grande
Sintomo: lentezza o time‑out.
Soluzione: disattiva Include Binary se non necessario; gestisci i file a parte (es. storage esterno).

Check rapido:

Il Field to Split Out è corretto?
L’array contiene elementi?
Serve disabilitare la dot notation?
Stai includendo solo i campi necessari?

Keyword integrate: troubleshooting su array e campi annidati, trasformare elenco in item singoli.

[IMG: Vista dati con highlight del path corretto per Field to Split Out]

3 mini‑workflow per marketer: dal dato alla campagna

Import prodotti e posting social

HTTP Request (API prodotti) → Split Out su products
Filter per categoria/stock → Set per copy promozionale
Social (X/LinkedIn) e Discord/Slack per annuncio
Aggregate per report post‑pubblicazione
Valore: processare risultati API in n8n e pubblicare contenuti mirati.

Lead enrichment da Google Sheets

Google Sheets → Split Out su rows
HTTP Request verso Clearbit/CRM per arricchimento
Merge By Key (email) con la riga originale
Update Sheet con “score” aggiornato
Valore: esempi di workflow n8n con liste per qualificare lead.

UGC con immagini

Webhook che riceve payload con lista asset → Split Out su assets
Include Binary ON solo se necessario
Moderazione AI → Upload a DAM/Drive
Aggregate per inviare galleria al team
Valore: gestione dati binari in automazioni n8n ottimizzata.

Keyword integrate: unire risultati dopo la suddivisione (Merge Items), best practice per loop su liste in n8n.

[IMG: Canvas dei 3 mini‑workflow con annotazioni essenziali]

Quick Takeaways

Split Out “spacchetta” un array in item singoli: ideale per elaborare array JSON in n8n e attivare azioni per ogni elemento.
Configura con precisione: Field to Split Out, Include (No/All/Selected Other Fields + Fields to Include), Disable Dot Notation, Destination Field Name, Include Binary.
Preferisci Split Out per array annidati in un item; Loop Over Items per batch e controllo del ritmo su item già esistenti.
Dopo lo split, usa Filter/Enrich e poi Aggregate/Merge per ricomporre risultati o creare report.
Evita payload pesanti: limita i campi con Include=Selected e tieni OFF Include Binary se non serve.
Implementa validazioni pre‑nodo e rami di errore per flussi robusti e facilmente manutenibili.

Conclusione

Il nodo split out n8n è una leva potente per chi fa marketing data‑driven: trasforma array complessi in una pipeline di azioni atomiche, leggibili e scalabili. Impostando con cura Field to Split Out e le opzioni di Include, puoi decidere quanto del contesto originale mantenere, mentre Disable Dot Notation e Destination Field Name ti aiutano a evitare collisioni e a dare struttura chiara all’output. Nei flussi reali, Split Out brilla quando viene combinato con Filter, arricchimento via HTTP Request e ricomposizione con Aggregate o Merge, sbloccando casi d’uso come import prodotti, enrichment lead, publishing e moderazione UGC. Per massimizzare la produttività del team, standardizza naming e validazioni, monitora gli errori e sfrutta Loop Over Items per batch rate‑limited. Ora che conosci parametri, pattern e troubleshooting, costruisci il tuo prossimo workflow: parti da un array, “spacchettalo” in item, applica le azioni e ricomponi solo quando serve. È il modo più veloce per passare dai dati all’impatto, mantenendo i flussi leggibili per tutto il team.

FAQ

Cos’è n8n Split Out e quando dovrei usarlo?

È il nodo che trasforma un array in più item. Usalo quando devi elaborare array JSON in n8n (es. results di un’API) e attivare azioni per ogni elemento senza scrivere codice.

Come decido cosa mantenere dall’item originale?

Con Include puoi scegliere tra No Other Fields, All Other Fields o Selected Other Fields. In quest’ultimo caso, compila Fields to Include per l’inclusione campi nel nodo di suddivisione.

Devo preoccuparmi dei campi annidati o con punti nel nome?

Sì. Se la dot notation in n8n crea ambiguità (nomi con punti letterali), attiva Disable Dot Notation nelle Node options per interpretare i nomi letteralmente.

Come ricompongo i risultati dopo lo split?

Puoi unire risultati dopo la suddivisione (Merge Items) con Aggregate per creare un array unico, oppure usare il Merge node (By Key/Index) per combinare stream diversi. Utile per processare risultati API in n8n e produrre report finali.

Qual è la differenza tra Split Out e Loop Over Items?

Split Out serve a trasformare elenco in item singoli quando l’array è dentro un item; Loop Over Items (Split In Batches) itera su item già esistenti con controllo su batch e ritmo. Scegli in base alla struttura dei tuoi dati e alle esigenze di performance.

Hai due minuti?

Ti è stata utile questa guida sul nodo split out n8n? Raccontaci nei commenti il caso d’uso che vuoi implementare e condividi l’articolo sui social per aiutare altri marketer. Quale lista/array vorresti “spacchettare” per accelerare la tua prossima campagna?