Introducing Subgraphs: A Powerful New Feature Coming to ComfyUI

CN
ComfyUI.org
2025-06-12 09:13:15

The ComfyUI team is excited to announce an upcoming feature that will transform workflow creation: Subgraphs. The public beta will be available in the coming week for all users to experience.

What Are Subgraphs?
Subgraphs are complete ComfyUI workflows packaged as custom super-nodes with defined inputs and outputs. They offer all the familiar editing tools of regular workflows, requiring no additional learning.

Evolution from Group Nodes
While group nodes provided basic functionality, subgraphs represent a complete redesign that addresses all user needs. Existing group nodes will automatically upgrade to subgraphs when the feature launches.

Simplify Complex Workflows
The "Collapse to Subgraph" feature lets users select nodes, groups, and reroutes, converting them into a single, organized subgraph node. This dramatically reduces visual clutter while maintaining full editability.

Editing Flexibility
Subgraphs can be edited through:

  • Double-click to open

  • Right-click context menu

  • New tab or in-place editing

Changes propagate automatically to all instances, while cloned subgraphs remain independent for customized variations.

Seamless Connections
Linking subgraphs works intuitively:

  • Main workflow connections remain unchanged

  • Internal connections use dedicated Input and Output nodes

  • New connection slots appear automatically when needed

Widget Integration
Widgets enable:

  • Parameter control at the subgraph level

  • Automatic type handling and constraints

  • Simplified user interfaces by exposing only essential controls

Nested Workflows 🪺
Subgraphs support nearly unlimited nesting, enabling:

  • Utility libraries

  • Complex abstractions

  • Shareable, understandable workflows

Coming Soon
The subgraph branch is already available for developers who build from source. All users can expect the beta release soon - update your ComfyUI installation to access it immediately upon release.