Save Plate:
Save Plate writes your finished shot while preserving the original plate’s format and production details, rather than exporting it as a generic image or movie. It is designed to retain the original file type, bit depth, frame numbering, colour tags, timecode, and audio through the plate-writing tools. For EXR files, it also supports preserving additional layers and header attributes, with the data window—the rectangle containing stored pixels—expanded only when necessary to include an edit outside it. Source alpha is preserved unless you supply a replacement when saving still frames. For local edits, the node can restore exact source pixels outside the changed area, helping protect parts of the shot that should remain untouched. This makes it useful for returning AI-assisted edits to a compositing or finishing workflow without unnecessarily replacing the surrounding image or discarding important plate information.
Save Plate Input Parameters:
images
Required IMAGE input containing the finished frames to save. Supply frames in the plate’s colour space; this node does not explicitly perform a colour-space conversion before handing them to the file-writing tools. The number of frames processed is the smaller of the supplied image batch length and the frame count recorded in the plate information, so extra images beyond that count are not saved. For a complete shot, provide the full intended sequence in the correct order. No default value, minimum, maximum, or selectable options are defined for this input.
plate
Required PAINTAPLATE_PLATE input containing the original plate’s source information and saving specifications. This is the extension’s custom plate data, not an ordinary image connection. It tells the node whether to write a video or still frames and provides information such as the source path, frame count, and file extension. The saving tools use this information to preserve the plate’s format and associated details. Connect the plate data associated with the shot you are editing, normally obtained through the plate-loading workflow. No default value, minimum, maximum, or selectable options are defined.
filename_prefix
Required STRING input with a default of paintaplate/shot. Despite its name, this setting selects a destination folder under ComfyUI’s output folder rather than assigning a new filename prefix to every frame. Still frames keep the plate’s names, and a video is saved using the original source video’s basename. For example, paintaplate/shot_edit_v02 can separate a new version from previous exports. The node creates the destination folder if necessary. No minimum length, maximum length, or predefined options are specified in the schema.
keep_untouched
Required BOOLEAN input with options True and False and a default of True. When enabled and a changed mask is connected, the node asks the saving tools to copy original source pixels wherever that mask is zero, protecting areas outside your edit from unintended changes. When disabled, the provided image frames are saved without requesting this source-pixel restoration. This setting does not activate restoration by itself: if changed is absent, no preservation mask is passed to the writer. Enable it for localized edits, but disable it when the entire image should change, such as after a full-frame relight or grade. Numeric minimum and maximum values do not apply.
changed
Optional MASK input identifying where pixels are allowed to differ from the original plate. When keep_untouched is enabled, zero-valued areas identify source pixels to restore; the marked edit area can retain the processed image. This is a preservation boundary, not a substitute for compositing your edit into the image beforehand. If the mask batch is shorter than the saved sequence, the final available mask is reused for subsequent frames. The source does not specify numeric minimum or maximum values or define how partially valued mask pixels are interpreted by the underlying preservation helper, so do not assume this behaves like an ordinary soft-opacity blend. No default mask is supplied; leaving it disconnected disables source-pixel restoration.
alpha
Optional MASK input supplying replacement alpha when saving still images or image sequences. Alpha controls image transparency and is separate from changed, which controls restoration of original colour pixels. Leave this input disconnected to retain the source alpha according to the plate-writing behavior. The video-saving branch does not use this input. For still sequences, the node directly indexes one alpha frame for each saved image and does not repeat the last alpha automatically, so provide enough alpha frames for the entire saved sequence. No numeric minimum, maximum, or explicit default mask is defined; the default behavior is no replacement alpha.
Save Plate Output Parameters:
(none)
This node has no connectable output parameters. It is an output node that saves files to disk rather than returning an image, mask, or plate connection for further processing. Its execution result includes a text summary containing the number of files written, destination folder, any writer notes, and up to three saved filenames. It also records file references for the extension’s job tracking and render-folder lookup; these are interface metadata, not node output sockets. A video normally appears as one written file, while a still sequence produces one file per saved frame.
Save Plate Usage Tips:
- Keep your finished frames in the original plate’s colour space before saving. Use an appropriate colour-conversion step upstream if your editing or generation workflow operates in another colour space.
- For a localized replacement or cleanup, use
keep_untouched=Trueand connect achangedmask covering every area that should retain edited pixels. Check the mask across the whole shot so that moving edits are not accidentally restored to the original plate. - For a full-frame relight, grade, or other global change, set
keep_untouched=False. Otherwise, zero-valued areas in a connectedchangedmask can undo parts of the intended change. - Complete your compositing before this node. The
changedmask identifies where differences are permitted; it should not be treated as the blend control that places an unfinished generated patch over the original image. - Use a separate destination such as
paintaplate/shot_v03for each export version. The folder changes, but the original plate filenames are retained. - Check frame counts before export. Only the smaller of the image batch length and plate frame count is processed; a short image batch does not automatically extend to match the plate.
- Leave
alphadisconnected when you want to preserve the original transparency. When replacing alpha for a still sequence, provide a matching sequence of alpha masks rather than relying on automatic repetition. - For multilayer EXR delivery, confirm that OpenEXR is installed and review the saving summary for warnings. Preserving extra EXR layers depends on that support being available.
Save Plate Common Errors and Solutions:
OpenEXR is not installed: extra EXR layers were not copied.
- Explanation: This is an explicit warning from the node. An EXR export was processed without the OpenEXR support needed to copy additional layers, so the result should not be treated as a fully preserved multilayer delivery.
- Solution: Install OpenEXR in the Python environment used by ComfyUI, restart ComfyUI, and export again. Verify the saved file’s layers before delivery.
Edited areas revert to the original plate
- Explanation: With
keep_untouched=True, zero-valued areas ofchangedare restored from the source. An incomplete, inverted, or incorrectly timed mask can therefore remove intended edits. This is a result issue rather than a specific error message emitted by the node. - Solution: Preview the mask and ensure that it marks all areas intended to change. For a full-frame edit, turn
keep_untouchedoff.
Untouched areas are not restored
- Explanation: Source-pixel restoration requires both
keep_untouched=Trueand a connectedchangedmask. Enabling the switch without supplying the mask does not activate restoration. - Solution: Connect an appropriate edit mask and enable
keep_untouched. Confirm that regions you want restored are zero in that mask.
IndexError while saving replacement alpha
- Explanation: The still-image branch accesses
alphaat each saved frame index. If the alpha batch is shorter than the saved image sequence, an out-of-range indexing error can occur; the precise error wording depends on the runtime. - Solution: Supply one alpha frame per saved image, explicitly repeat a static alpha upstream if needed, or disconnect
alphato preserve the source alpha.
Fewer frames are saved than expected
- Explanation: The node intentionally processes only the smaller of the image batch length and the plate’s recorded frame count. Also, a completed video is counted as one file rather than one file per frame.
- Solution: Compare the supplied image count with the plate frame count. If exporting video, inspect its duration or frame count instead of interpreting the file-count summary as a frame count.
PermissionError or an output-folder creation failure
- Explanation: The node creates the destination directory and writes files there. An unwritable ComfyUI output location, restricted folder, or filesystem problem can prevent saving. The exact message comes from the operating system or writing tool.
- Solution: Use a valid destination under ComfyUI’s output folder, confirm that ComfyUI has write permission, and check available disk space.
Replacement alpha has no effect on a video export
- Explanation: The node’s video-saving branch does not read
alpha, so connecting it does not replace the movie’s alpha through this implementation. - Solution: Use the supported still-image or image-sequence workflow when you need to provide replacement alpha through this node, and verify that the plate’s image format supports the required transparency.
Saved images have an unexpected colour appearance
- Explanation: The node expects frames already in the plate’s colour space and does not explicitly convert them before saving. A colour-space mismatch or a viewer’s display transform can therefore produce an unexpected appearance without a node error.
- Solution: Check the colour space of your finished frames, convert them to the plate’s expected space upstream, and compare the source and saved result using the same viewing settings.
