ImageCompositor - ComfyUI Built-in Node Documentation

This node combines multiple image layers into a single composited image. It takes a layer stack built with the Add Layer node and optionally applies saved composition settings from the compositor editor, blending the layers according to their placement, size, rotation, opacity, and blend mode. A saved composition that matches the current inputs takes priority; otherwise the node composes from the layer properties and marks the saved state as stale.

Inputs

Parameter	Description	Data Type	Required	Range
`layers`	Layer stack to composite; build it with Add Layer. Items are stacked by z_index, batch frames inside an item expand to consecutive layers, and item placement, opacity, and blend mode define the initial composition. Without an explicit document canvas the size is a best-effort maximum extent of the placed layers. A saved composition that matches the current inputs takes priority.	LAYERS	Yes	Maximum 50 layers
`compositor`	Layered composition saved by the compositor editor.	COMPOSITOR	No	None

Notes on constraints:

The layer stack supports a maximum of 50 expanded layers; providing more raises an error.
Only raster layer items are currently supported; other item types raise an error.
The layers document version must be 1; other versions raise an error.
Saved compositor state is only replayed when its recorded input fingerprints match the current layer stack. If they do not match, the node falls back to composing from the layer properties and marks the saved state as stale.
Layer opacity is clamped to the range 0.0 to 1.0.
Layer horizontal and vertical placement (x, y) is clamped to the maximum resolution limit.
Layer width and height fall back to the natural image size when set to zero or less, and are capped at the maximum resolution limit.
The composited canvas size must not exceed the maximum resolution limit.
When no layers are provided, a 64x64 placeholder image is returned.

Outputs

Output Name	Description	Data Type
`IMAGE`	Composited image. Carries an alpha channel when the composite has transparent areas (e.g. hidden background), otherwise plain RGB.	IMAGE
`MASK`	Transparency of the composite (1 = fully transparent). All zeros when the composite is opaque.	MASK

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): 76e5e57ade89f9ee172c5e1f0b82579d846d15bafb52b2052246f1f2ad7f0034

​Inputs

​Outputs

Inputs

Outputs