Orchestration Logic

How to arrange, nest, or reuse nodes when building a Workflow or Chatflow

Serial and Parallel Execution

When building a workflow, you can arrange nodes in series or in parallel:

• In series, nodes run one after another. Each node can read variables from any node earlier in the chain.

• In parallel, nodes run at the same time. They can’t read each other’s variables, but where parallel branches converge, the downstream node can read from all of them.

A single execution path supports up to 50 nodes. Self-hosted deployments can change this limit with the MAX_TREE_DEPTH environment variable.

Node Reuse

All nodes except User Input can be copied and pasted within the same workflow, across workflows, or across Dify instances, though there might be compatibility issues between Dify versions.

Pasting across workflows or Dify instances requires the Dify page to be served over HTTPS or accessed via a loopback address (such as http://localhost or http://127.0.0.1).

When you paste a node, its configuration moves with it, but the availability of anything that depends on the surrounding environment is re-evaluated at the destination:

• Workflow-specific resources, such as variables
• Workspace-specific resources, such as tools, plugins, and knowledge bases

Iteration and Loop

For nodes that should run multiple times (once per item in a list or until a condition is met), place them inside an Iteration or Loop node.