Interactive Tutorial: Mastering Data Flow, Execution & Debugging - n8n Workflow

• Developers and programmers transitioning to visual automation platforms.


• New users of n8n seeking deep technical knowledge on data flow and execution.


• Users who want to understand how an n8n node processes single versus multiple items.


• Anyone looking for robust n8n templates focusing on core logic and debugging techniques.

This comprehensive n8n workflow acts as a living document and tutorial, guiding new users through the critical, often unintuitive aspects of building automations in n8n. It addresses fundamental concepts like how data items transform the flow of execution, the crucial difference between execution paths, and proper data referencing. Unlike passive documentation, this interactive n8n template allows users to execute and debug concepts live, ensuring a robust understanding of the n8n data model and flow control. Mastering this core logic is essential for creating reliable and complex n8n solutions.

This self-guided n8n workflow uses a series of Form nodes to pause and present lessons, requiring user interaction to proceed, allowing for live inspection of data paths.

1. Initiation: The n8n workflow starts with the Form Start n8n trigger, prompting the user to begin the tutorial.


2. Flow Control: The workflow first demonstrates sequential execution: when a node connects to multiple paths, the top path (Do Thing 1) always completes entirely before the bottom path (Do Thing 2) begins.


3. Data Scope & Isolation: It shows how data set by a Set n8n node is naturally isolated to its branch (Cant See It cannot access parallel data).


4. Merging Data: The Merge n8n node (set to Combine) is then used to successfully unify data from separate branches into a single flow item, which is then accessible by the Can See Both form.


5. Execution Modes: Multiple Code nodes are used to generate several data items, demonstrating the fundamental concept that passing multiple items causes downstream n8n nodes to execute once per item, unless configured otherwise.


6. Aggregation: The Aggregate Items n8n node shows how to consolidate five separate data items back into one single item containing an array, followed by the Split Out node to reverse the process.


7. Advanced Control: The n8n workflow introduces the Loop Over Items (Split In Batches) node for iterative processing and uses the Only Once configuration on a NoOp n8n node to intentionally throttle a multi-item flow back to a single execution.


8. Debugging: The final step directs the user to inspect the workflow's logs, a vital step for debugging any complex n8n workflow.

1. Import: Copy the entire JSON code provided above.


2. Open n8n: In your n8n instance, click the '+' to create a new workflow.


3. Import from JSON: Click the 'Import from JSON' button located in the top right corner and paste the copied n8n workflow JSON.


4. Execution: Since this n8n template uses a Form Start n8n trigger, you do not need external credentials. Click 'Execute Workflow' to open the interactive form and begin the tutorial. Follow the instructions provided in the Sticky Note nodes and the interactive form windows. Remember to frequently stop execution to inspect the configurations of each n8n node as instructed.

• Form Start (n8n Trigger): Serves as the interactive starting point for the tutorial. It launches a web form that controls the execution pace of the entire n8n workflow.


• Form (n8n Node): Used extensively throughout the n8n workflow to pause execution, provide explanatory text, and display the results of data manipulation tests.


• Sticky Note: Contains the bulk of the instructional content, guiding the user through each concept, such as data flow rules and execution modes.


• Set: A core n8n node used to create and assign key-value pairs (myvalue1e, myvalue1f) to demonstrate how data is carried through the flow.


• Merge: Configured with mode: combine, this n8n node is crucial for showing how data from two parallel execution branches can be successfully brought together.


• Code: Used to dynamically generate test data (e.g., Create Three Items, Create Five Items) and to demonstrate the differences between running an n8n node 'once for all items' versus 'once for each item'.


• Aggregate Items: This node collapses a stream of multiple data items (e.g., 5 items) into a single data item containing an array of all original items, demonstrating batch processing preparation.


• Split Out: The inverse of Aggregate, this n8n node takes an array within a single item and expands it back into multiple individual items, restarting the item-based execution flow.


• NoOp: Used primarily for layout, but one instance is configured to executeOnce: true to demonstrate limiting downstream execution flow from multiple items back down to one, a powerful n8n node technique for flow control.