Overview
The node is an Advanced Randomizer that routes incoming data items randomly across multiple outputs based on user-defined percentage probabilities. It allows users to split the input data into several output paths, each with a customizable chance of receiving any given item.
This node is useful in scenarios such as:
- Load balancing or distributing workload randomly but proportionally.
- A/B testing workflows by sending different proportions of data to different branches.
- Simulating random sampling or probabilistic routing in automation pipelines.
For example, if you want to send 70% of data to one process and 30% to another, you configure two outputs with those percentages, and the node will route each item accordingly.
Properties
| Name | Meaning |
|---|---|
| Outputs | A collection of outputs where each output has: |
| - Output Name: The label for the output path (e.g., "Path A", "Variant 1"). | |
| - Percentage: The probability (0-100) that an item will be routed to this output. | |
| The sum of all percentages must equal 100%. You can define between 2 and 10 outputs. |
Output
The node outputs multiple main outputs corresponding to the configured outputs. Each output contains the subset of input items randomly assigned to it according to the specified percentages.
- The
jsonfield of each output contains the routed data items. - No binary data output is produced by this node.
Dependencies
- No external services or API keys are required.
- This node relies solely on internal randomization logic.
- No special environment variables or n8n credentials are needed.
Troubleshooting
Error: "Configure at least two outputs."
Occurs if fewer than two outputs are configured. Fix by adding at least two outputs.Error: "The sum of all percentages must be 100%. Current total: X%"
Happens when the sum of all output percentages does not equal exactly 100%. Adjust the percentages so their total is 100%.If outputs receive no data, verify that the percentages are set correctly and that input data exists.