Sub-Workflow Input
Define the inputs of a workflow that other workflows call as a Sub-Workflow. Each port has a name and a type, and pairs with a Sub-Workflow Output by route.
The Sub-Workflow Input node defines the inputs of a workflow that other workflows call through a Sub-Workflow node. Each port has a name and a type, and becomes an input on the calling node. Inside the workflow, the value that arrives on a port flows to the nodes you connect to it. Pair every Sub-Workflow Input with a Sub-Workflow Output to complete the route.
When to use it
- You want an image processing pipeline that other workflows can call.
- You want a video composition workflow that accepts different media each time it is called.
- You want several entry points into one workflow, one per route.
Quick start
Add the node
Open the workflow that other workflows will call. Press Tab on the canvas and choose Automate › Workflows › Sub-Workflow Input. The node receives a route ID automatically.
Define the ports
Open the settings panel. Under Ports, name the first port and choose its type. Click Add for each further input, for example "Reference" as an image and "Prompt" as text.
Connect the ports
Each port has its own output on the right of the node. Connect each one to the nodes that use it.
Pair it with an output
Add a Sub-Workflow Output, choose this input under Paired Input Route, and save the workflow.
When you use Create empty sub-workflow in a Sub-Workflow node, the new child workflow already contains a paired Sub-Workflow Input and Sub-Workflow Output.
Outputs
The node has one output per port, colored by the port's type. When a Sub-Workflow node runs this route, each output carries the value that the caller connected to the matching input.
Settings
| Setting | What it does |
|---|---|
| Label | The route's name. The calling Sub-Workflow node shows it in its Route list. |
| Route ID | The identifier that pairs this input with a Sub-Workflow Output. It is created automatically and cannot be edited. If it is ever empty, click Generate. |
| Ports | The inputs of the route. Each port has a name and a type: Text, Image, Video, Audio or Any. A new node has one port, "Input", of type Any. Add adds another port. The last port cannot be removed. |
A copy of a Sub-Workflow Input receives a new route ID, so the copy starts a separate route.
Rules
When you save the workflow, Nodaro checks two rules. Every Sub-Workflow Input needs a Sub-Workflow Output with the same route ID, and no two Sub-Workflow Input nodes can share a route ID. A save that breaks a rule is refused, and each problem is listed.
Credits
The Sub-Workflow Input node is free.
Tips
- Name ports for the caller. "Background Video" or "Narration Text" tells the person who uses the workflow what to connect.
- Use specific types. A specific type, such as Image, catches a wrong connection early. Any accepts everything.
- One port per value. When the workflow needs an image and a prompt, give it two ports.
Frequently asked questions
Related
Sub-Workflow
Sub-Workflow Output
Components and sub-workflows
Component
Last updated on
Component
Add a published component, a versioned workflow from the community or your own, as one node. Set its inputs and settings, and it runs as a black box.
Sub-Workflow Output
Define what a callable workflow returns. Pair it with a Sub-Workflow Input, add typed output ports, and choose which result the caller shows as its preview.