Nodes/WWAA-CustomNodes/🪠️ WWAA Image Grid
ComfyUI Node

🪠️ WWAA Image Grid

Stack a whole batch into a tidy grid, empty cells and all

By hgabha·Created 2 years ago·Updated 6 months ago· 38
🪠️ WWAA Image Grid
  • images
  • grid_image
rows2
columns2
background_color#000000
output_scale100

The WWAA Image Grid node takes an image batch and arranges it into a rows×columns grid, one composite image out. If you generate a batch of variations and want a contact sheet to compare them, this is the node - feed the batch of sampled images in, pick a grid size, and out comes a single image you can save or eyeball.

It's part of the WWAA-CustomNodes pack from WeirdWonderfulAI.Art. The twist that distinguishes it from a plain grid assembler: it doesn't require the batch to exactly fill the grid. If you have 5 images and a 3×3 grid, it places the 5 and leaves the remaining 4 cells as your chosen background_color rather than erroring or duplicating. That's genuinely convenient when batch counts vary run to run.

How it works

Every image in the input batch gets resized to the same cell size (that of the first image, using LANCZOS resampling) and pasted left-to-right, top-to-bottom. Cells beyond the batch just stay the background color. The background_color input is a hex string like #000000 - give it a malformed hex and it quietly falls back to black, so it's worth checking that field if your grid background looks wrong. output_scale is a percentage (1–100) that shrinks the final composite; this node caps at 100%, so it can only downscale, not upscale.

The single output is grid_image, a fresh composite you can save with a Save Image node or send to a preview. Because the batch size can be smaller than the grid, this pairs well with the stateful WWAA Image Batch Loader feeding it a few images at a time.

Inputs that matter

  • rows / columns - grid shape, 2–20 each.
  • background_color - hex fill for empty cells.
  • output_scale - percentage downscale; 100 = full size.

Installing it

It ships in WWAA-CustomNodes, so install the pack:

cd ComfyUI/custom_nodes
git clone https://github.com/hgabha/WWAA-CustomNodes

Restart ComfyUI. Or ComfyUI Manager → search "WWAA Custom Nodes" → Install → restart. It's under 🪠️ WWAA/image. No models, and the pack declares no extra dependencies.

Gotchas

The main thing to know is the sibling node: if you're working with a video or animation sequence and want a representative grid (first frame, last frame, evenly spaced middles), use WWAA Advanced Image Grid instead - this one just fills cells in batch order. And if the node doesn't appear after install, remember the pack's image nodes import OpenCV at module load; a ComfyUI Python environment missing opencv won't register the whole image menu. Install opencv-python into the same environment ComfyUI runs in and the WWAA image nodes come back. Otherwise, this is a small, predictable utility - set rows and columns, feed a batch, get a grid.

Category🪠️ WWAA/image

Inputs (5)

NameTypeDefaultDescription
imagesIMAGE
rowsINT22–20
columnsINT22–20
background_colorSTRING#000000
output_scaleINT1001–100

Outputs (1)

NameTypeDescription
grid_imageIMAGE