StyloDocs
Workflow blocks

Parallel

Execute a branch once per item and then continue after join

View as Markdown

system/parallel — Execute a branch once per item and then continue after join.

Where it appears

The Parallel block lives in the Logic & control group of the Workflow Builder.

Fields

FieldTypeRequiredDefaultDescription
itemstext (multi-line, supports references)YesThe array fanned out across branches — one branch runs per element. Accepts a literal JSON array or a <PreviousStep.field> reference to an upstream array output.
maxBranchestext (supports references)NoHard cap on total branches. Items beyond this index are skipped — useful as a safety net when the input array could be unexpectedly large. Default: 100.
concurrencytext (supports references)NoHow many branches run at the same time. Subsequent branches start as in-flight branches finish, until all branches complete. Lower this to throttle downstream APIs. Default: 5.
joinPolicyselectNoallSuccessHow the join after the branches behaves. All Success only continues past the join if every branch succeeded; Always continues regardless of branch failures. Options: allSuccess, always.

Inputs and outputs

Inputs are the configurable fields above. The block produces these outputs:

Outputs

Reference an output downstream with <Parallel.field>.

NameTypeDescription
itemsarrayItems iterated over
branchesnumberNumber of branches executed

Example

A minimal configuration for this block:

{
  "type": "system/parallel",
  "config": {
    "items": "<PreviousStep.field>",
    "joinPolicy": "allSuccess"
  }
}

Limits and failure modes

  • Required field (items) must be set, or the block fails validation before it runs.

On this page