●Change8

Migrating to ComfyUI v0.16.0

Version v0.16.0 introduces 1 breaking change. This guide details how to update your code.

Released: 3/5/2026

1
Breaking Changes
3
Migration Steps
6
Affected Symbols

⚠️ Check Your Code

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

WanVAEResolutionSelectorVAEDecodeAudioTiledVideoFromComponentsModelPatcherDynamicMahiro CFG (renamed to Similarity-Adaptive Guidance)

Breaking Changes

●Issue #1

Class WanVAE definition changed: `def encode` now uses `self.decoder` instead of `self.encoder`.

✓Solution

Review usage of `WanVAE.encode` and ensure it correctly interacts with the decoder component if necessary.

Migration Steps

  1. 1
    If you were using `WanVAE.encode`, check if it relies on `self.encoder` and update it to use `self.decoder` as per the change in PR #12682.
  2. 2
    If using Dynamic VRAM, note that the default behavior for the `--disable-smart-memory` CLI argument is now to disable dynamic vram.
  3. 3
    If using Dynamic VRAM, note that the initial load device defaults to CPU.

Release Summary

This release introduces significant enhancements to memory management, particularly around Dynamic VRAM, adds support for new models like SDPose-OOD and SCAIL WanVideo, and includes numerous bug fixes across tiling, VAE decoding, and model loading.

Need More Details?

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

View Full Changelog