Nodes/KayTool/𝙆 Custom Save Image
ComfyUI Node

𝙆 Custom Save Image

Filename templating, color profiles and metadata in one save node

By kk8bit·Created 2 years ago·Updated about a year ago· 364
𝙆 Custom Save Image
  • images
    preview_onlyfalse
    filename_prefixCustom_Save_Image
    color_profilesRGB IEC61966-2.1
    formatPNG
    jpg_quality95
    author
    copyright_info
    save_metadatafalse

    The stock Save Image node in ComfyUI gives you a filename prefix and that's about it. Custom Save Image is what you reach for once you actually care about your output files - dynamic filenames built from the generation parameters, a choice of color profile so the colors you see are the colors you get elsewhere, embedded metadata, and JPG support with a real quality slider instead of only PNG.

    How it works

    The filename templating is the standout feature. filename_prefix isn't just static text - you can drop in variables and the node fills them in per-run: %date:yyyy-MM-dd% and %time:HH-mm-ss% for a timestamp, %width% and %height% for the output dimensions, and a set of %KSampler.*% variables (seed, steps, cfg, sampler_name, scheduler, denoise) that pull straight from a KSampler node in your graph - if you've got more than one KSampler, they auto-number (_1, _2) so you can tell which pass produced which value. That turns a folder of ComfyUI_00001_.png files into something you can actually search and sort by seed or resolution later. One thing the author's own docs flag explicitly: these variable names are case-sensitive, so %Width% won't work where %width% does.

    Color profile matters more than people expect - sRGB IEC61966-2.1 is the safe universal default; Adobe RGB (1998) is a wider gamut worth picking only if your downstream pipeline (print, a color-managed viewer) actually expects it. Get this wrong and colors can look subtly off once the file leaves ComfyUI. save_metadata embeds author info, copyright, and the generation prompt into the file itself - useful for provenance, easy to forget exists.

    The inputs that matter

    • images (IMAGE) - required.
    • preview_only (BOOLEAN) - test your setup without writing files to disk.
    • filename_prefix (STRING) - supports the dynamic variables above.
    • color_profile (sRGB IEC61966-2.1 / Adobe RGB 1998) and format (PNG / JPG).
    • jpg_quality (0–100) - only relevant when format is JPG.
    • author / copyright_info (STRING) and save_metadata (BOOLEAN) - for embedding provenance info.

    No outputs - this is a terminal save node, same as the built-in one.

    Installing it

    Comes with the full KayTool pack: ComfyUI Manager → search KayTool → install → restart, or cd ComfyUI/custom_nodes && git clone https://github.com/kk8bit/KayTool and restart. The one thing worth reading twice in the pack's own install notes: the color profile files this node relies on need to actually be sitting in the resources folder inside the KayTool install. A normal git clone or Manager install brings that folder along automatically - this only becomes a problem if you've done something unusual, like copying files by hand or working from an incomplete download, in which case color_profile may not embed correctly even though the node runs without erroring.

    Common issues

    If the file gets written but the color profile doesn't seem to be applied, check that the resources folder actually came through in your install (see above) before assuming the node's broken. If a %KSampler.*% variable isn't resolving in your filename, confirm there's actually a KSampler node in the same workflow graph - the node reads those values live from the graph, so it can't fill in a variable for a parameter that doesn't exist anywhere upstream. And remember preview_only - it's an easy toggle to leave on by accident after testing, which means you generate a batch, look confused why nothing landed in your output folder, and then realize the save was never actually happening.

    CategoryKayTool

    Inputs (9)

    NameTypeDefaultDescription
    preview_onlyBOOLEANfalse
    imagesIMAGE
    filename_prefixSTRINGCustom_Save_Image
    color_profileCOMBOsRGB IEC61966-2.12 options: sRGB IEC61966-2.1, Adobe RGB (1998)
    formatCOMBOPNG2 options: PNG, JPG
    jpg_qualityINT950–100
    authorSTRING
    copyright_infoSTRING
    save_metadataBOOLEANfalse

    Outputs (0)

    No outputs