Create Grid Image from Batch

You generated a batch of eight variations and now you want them side by side in one image to compare at a glance - not eight separate files to click through. Create Grid Image from Batch takes a batch of images and lays them out into a single grid, like a contact sheet. It's the fast way to make an XY-style comparison or a tidy preview strip out of a batch you already rendered.

Nothing fancy, but it's the node that turns "a batch of results" into "one image I can post or eyeball." Very handy for showing off a seed sweep or a prompt comparison in a single frame.

How it works

It receives a batch tensor of images - the thing that comes out of any node producing more than one image at once - and composites them into rows and columns on one canvas. The README notes optional border size and color, so you can put spacing and a frame between cells rather than butting the images edge to edge. The result is a single image with all the batch members tiled inside it.

The distinction worth knowing: this one works on an in-memory batch (the images flowing through your current graph). Its cousin "Create Grid Image" builds a grid from files sitting in a folder via a glob pattern. Same output, different source - reach for this when the images are already in your pipeline as a batch, and the folder version when they're on disk.

Inputs and outputs that matter

The input that matters is the image batch itself. Beyond that you're setting the border size and color for the gaps between cells. The output is a single IMAGE - the assembled grid - which you save (with Image Save or core's save node) or preview.

For this to be a batch, something upstream has to produce multiple images: a KSampler with a batch size above one, an Image Batch node combining several, or a loader pulling multiple frames. If you feed it a single image you get a one-cell "grid," which is not the point.

How to install it

ComfyUI Manager: search was-node-suite-comfyui, install, restart. Manually:

cd ComfyUI/custom_nodes
git clone https://github.com/WASasquatch/was-node-suite-comfyui

then install the pack's requirements.txt in your ComfyUI venv and restart. Grid assembly is Pillow/NumPy image math from the pack's requirements - no downloads.

Common issues & troubleshooting

The grid only has one image. Your input wasn't actually a batch. Set your sampler's batch size above one, or combine images into a batch first. A single image tiles to a single cell.

The layout looks uneven or cells are cropped. Grids assume the batch members share dimensions. If you've mixed sizes into one batch, the layout gets awkward - normalize sizes upstream so every cell is the same shape.

No spacing between images. Bump the border size; at zero the cells sit flush against each other. A few pixels of border with a contrasting color makes comparisons far easier to read.

The grid is huge. It's the sum of all the cells at full resolution. A batch of eight 1024px images makes a very large canvas. Downscale the images before gridding, or accept the size if you want full detail per cell.

Whole pack won't import after a ComfyUI update. The familiar WAS Node Suite issue - package downgrades vs a ComfyUI bump breaking the startup import. Re-run the pack's requirements against the activated venv, or install.bat. Maintenance-only since late 2023.