●Change8

Migrating to ComfyUI v0.21.0

Version v0.21.0 introduces 3 breaking changes. This guide details how to update your code.

Released: 5/11/2026

3
Breaking Changes
4
Migration Steps
17
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

video loader nodeSolidMask nodeMaskComposite nodepyav codesave 3d model nodeImageBlend nodeImageCompositeMasked nodeGPTImage2 nodeLoadImageMask nodeLoadImage nodeColorTransfer nodeSplitImageToTileList nodeImageMergeTileList nodeVAEDecodeAudio nodeDeviceStatsNodeInfoPromptRequest

Breaking Changes

●Issue #1

The `save 3d model` node's filename prefix has changed from its previous value to `3d/ComfyUI` (CORE-106). Users relying on the old prefix for file location may need to update their workflows or expectations.

●Issue #2

IPEX (Intel Extension for Pytorch) support has been removed (CORE-153). Users relying on IPEX must switch to standard PyTorch execution paths.

●Issue #3

The Moonvalley API nodes have been removed from partner nodes (CORE-159).

Migration Steps

  1. 1
    If you were relying on the old filename prefix for the `save 3d model` node, update your workflows to expect the new prefix: `3d/ComfyUI` (CORE-106).
  2. 2
    Remove any configurations or dependencies related to IPEX (Intel Extension for Pytorch) as support has been removed.
  3. 3
    If using the Moonvalley API nodes, they must be removed or replaced.
  4. 4
    The `ref_image` input is now mandatory for the `ColorTransfer` node (CORE-140).

Release Summary

This release introduces significant performance enhancements through Lora Async loading and dynamic VRAM management, alongside new features like Auto-regressive video generation and Gemma4 support. It also includes numerous bug fixes, particularly around media loading (pyav) and tensor handling, while removing IPEX support.

Need More Details?

View the full release notes and all changes for ComfyUI v0.21.0.

View Full Changelog