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!