Subgraphs Are Coming to ComfyUI! π
We have been busily working away preparing a new feature for you guys: Subgraphs!
In the coming week, we will be making the public beta available to anyone wanting to try it.
What Are Subgraphs?
A subgraph is a standard ComfyUI workflow with inputs and outputs. Think of them as custom super-nodes containing entire workflow sections.
The best part? Same editing tools as regular workflows β zero new learning curve.
What about Group Nodes?
Group nodes were our original attempt at providing this functionality, but trying to re-engineer them to provide all the features you need proved impractical. Subgraphs are built from the ground up to be better in every way. When weβre ready, existing group nodes will automatically be replaced with subgraphs.
Collapse to Subgraph
The best way to try out subgraphs is to take some of the clutter out of your workflow. Select any nodes, groups, and reroutes, then "collapse" them into a new subgraph. Everything gets neatly tucked inside a single subgraph node.
This is game-changing for complex workflows. Visual complexity disappears. Your workflow becomes clean, readable, and manageable.
Editing a Subgraph
Subgraphs are fully editable
Double click to open for editing
Right click, open from context menu
Edit in a new tab or in-place with double-click. Your choice.
Here's the magic: edits update all instances in a workflow automatically. Fix a bug once, and it is fixed everywhere.
Need the opposite of that? Subgraphs can be cloned, making a unique copy - editing a cloned subgraph wonβt impact the original.
Connecting Links
Connecting links is easy - thereβs just one extra step. Think of it like connecting two halves of the same link. One half is in the main workflow, the other is inside the subgraph.
In the main workflow: No change here - the same as connecting to a node
Inside subgraphs: Two special nodes handle everything β the βInputsβ node and the βOutputsβ node
Drop connections onto IO nodes, and new slots appear automatically. The inputs on the collapsed Subgraph Node in the workflow are connected to the special βInputsβ node inside the subgraph.
Using Widgets
What they do: Expose controls at the subgraph level
Why it matters: No more diving deep to adjust one parameter
How to add: Connect any widget to the input ionode
How it works: Automatic type handling, ranges, and constraints
Perfect for user-friendly templates. Hide complexity, expose what matters.
Nesting πͺΊ
You can make subgraphs inside subgraphs!
Nest to (almost) any depth. Create utility libraries. Build complex abstractions. Share sophisticated workflows that stay understandable.
Build once, use everywhere.
Coming Soon
We can't wait to see what you'll build. Get ready to take your workflows to the next level! π
If youβre comfortable building the frontend from source though, the subgraph branch is already public.
Update your ComfyUI to get access as soon as the beta drops, and join our Discord to share your subgraph creations with the community!
Thank you, LFG!
ζ£