Image Overlay (Mikey)

Image Overlay is the softer sibling of Image Paste. Where Image Paste stamps a foreground onto a background at a coordinate with zero blending, Image Overlay cross-fades the two images at a chosen opacity, pixel by pixel, across the whole frame. There's no x/y positioning here - it assumes both images are already the same size and just dissolves one into the other.

That makes it the right tool for a different job than Image Paste. Reach for Overlay when you want a subtle texture or vignette laid over a render, a semi-transparent watermark that doesn't fully obscure what's underneath, or a quick way to compare two outputs by nudging opacity back and forth. It's also a cheap way to fake a basic color-grade layer - generate or load a solid-color or gradient image, overlay it at low opacity, and you've got a tint pass without touching a real color-grading tool.

The inputs that matter: background_image and foreground_image, both IMAGE tensors, plus opacity - a float from 0 to 1 in steps of 0.01, defaulting to 1. At opacity 1 the foreground fully replaces the background, which functionally behaves like a paste (minus the coordinate control). At 0 it's a no-op and you just get the background back. Everything in between is a linear blend. The single output is result_img.

Because there's no offset or scale control, both inputs need to already match in resolution before you feed them in - if they don't, resize one to match the other upstream with a standard resize node. This node is intentionally doing one job well rather than trying to be a full compositor.

Installing it

Image Overlay ships as part of the full Mikey Nodes pack, not standalone. Install through ComfyUI Manager by searching "Mikey Nodes," or manually:

cd ComfyUI/custom_nodes
git clone https://github.com/bash-j/mikey_nodes

Restart ComfyUI. No model downloads or extra dependencies needed for this particular node - it's plain tensor math.

Common issues

The main failure mode is a size mismatch between the two images, which will either error out or produce a visibly misaligned blend depending on how ComfyUI's tensor broadcasting handles the discrepancy - don't count on it silently resizing for you. If your foreground came from a different part of the graph (a different latent size, a different upscale factor), drop a resize node in front of it first.

The other thing to know is that this node blends the entire frame uniformly - there's no mask input, so you can't selectively overlay just part of the image with this node alone. If you need masked, region-specific blending (say, only overlaying a texture inside a subject's silhouette), you'll want to combine this with a proper masking/compositing node from another pack, or pre-multiply your foreground against a mask before it reaches Image Overlay. As with the rest of Mikey Nodes, this one stays deliberately narrow rather than growing extra modes to cover every case - which is fine as long as you know to reach for a different node when you actually need masking.