SaveImageAdvanced - ComfyUI Built-in Node Documentation

The Save Image (Advanced) node saves the input images to your ComfyUI output directory with advanced control over file format, bit depth, and color space. It supports saving as PNG, EXR, or AVIF files (including animated AVIF) and can embed workflow metadata into the saved files.

Inputs

Common Inputs

Parameter	Description	Data Type	Required	Range
`images`	The images to save.	IMAGE	Yes	-
`filename_prefix`	The prefix for the file to save. May include formatting tokens such as `%date:yyyy-MM-dd%` or `%Empty Latent Image.width%`. (default: “ComfyUI”)	STRING	Yes	-
`format`	The file format in which to save the image. Selecting a format reveals additional options for that format.	DYNAMIC_COMBO	Yes	`"png"` `"exr"` `"avif"`

PNG Inputs

These options appear when format is set to "png".

Parameter	Description	Data Type	Required	Range
`bit_depth`	The bit depth for the saved PNG file. (default: “8-bit”)	COMBO	Yes (conditional)	`"8-bit"` `"16-bit"`
`input_color_space`	Colorspace of the input tensor. Only sRGB is available for PNG format. (default: “sRGB”)	COMBO	Yes (conditional)	`"sRGB"`

EXR Inputs

These options appear when format is set to "exr".

Parameter	Description	Data Type	Required	Range
`bit_depth`	The bit depth for the saved EXR file. (default: “32-bit float”)	COMBO	Yes (conditional)	`"32-bit float"`
`input_color_space`	Colorspace of the input tensor. The EXR is always written as scene-linear in the matching gamut. `"sRGB"` — input is sRGB-encoded Rec.709; the inverse sRGB EOTF is applied. `"HDR"` — input is HLG-encoded Rec.2020 (BT.2100); the inverse HLG OETF is applied to get scene-linear light. `"linear"` — input is already scene-linear (Rec.709 primaries); written through unchanged. Use this for renderer/compositor output. (default: “sRGB”)	COMBO	Yes (conditional)	`"sRGB"` `"HDR"` `"linear"`

AVIF Inputs

These options appear when format is set to "avif".

Parameter	Description	Data Type	Required	Range
`bit_depth`	The bit depth for the saved AVIF file. Auto uses 8-bit YUV420 for sRGB and 10-bit YUV420 for HDR. (default: “auto”)	COMBO	Yes (conditional)	`"auto"` `"8-bit YUV420"` `"10-bit YUV420"`
`input_color_space`	Colorspace of the input images. HDR selects BT.2020/HLG and HDR PQ selects BT.2020/PQ. (default: “sRGB”)	COMBO	Yes (conditional)	`"sRGB"` `"HDR"` `"HDR PQ"`
`crf`	Lower values produce higher quality and larger files. (default: 18)	INT	Yes (conditional)	1 to 63
`save_mode`	The save mode for the AVIF file. `"still images"` saves each image in the batch as a separate still file; `"animated"` saves the entire batch as a single animated AVIF file and reveals `fps` and `loop_count`. (default: “still images”)	DYNAMIC_COMBO	Yes (conditional)	`"still images"` `"animated"`

AVIF Animated Options

These options appear when save_mode is set to "animated".

Parameter	Description	Data Type	Required	Range
`fps`	The frame rate of the animation. (default: 6.0)	FLOAT	Yes (conditional)	0.01 to 1000.0
`loop_count`	Number of times to loop the animation. 0 loops forever. (default: 0)	INT	Yes (conditional)	0 to 1000

Notes on Parameter Dependencies:

The format-specific parameters (bit_depth, input_color_space, and for AVIF also crf and save_mode) are only available when a specific format is selected.
For PNG format, only “8-bit” and “16-bit” bit depths are available, and only “sRGB” color space.
For EXR format, only “32-bit float” bit depth is available, with “sRGB”, “HDR”, or “linear” color spaces.
For AVIF format, fps and loop_count are only available when save_mode is set to "animated".
PNG and EXR images must have 1 (grayscale), 3 (RGB), or 4 (RGBA) channels; other channel counts are not supported and raise an error.
AVIF supports only 1-channel grayscale and 3-channel RGB images; RGBA (alpha) images are not supported and raise an error.

Outputs

Output Name	Description	Data Type
`images`	The input images, passed through unchanged. The node’s UI output provides a list of saved image results, each containing the filename, subfolder, and type (“output”).	IMAGE

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): d3df3caca99d58d973d0bc2ff7c22c4626185d390ec2acf870d4014331c4c335

​Inputs

​Common Inputs

​PNG Inputs

​EXR Inputs

​AVIF Inputs

​AVIF Animated Options

​Outputs