Nodes/Comfyroll Studio/🌁 CR Image Grid Panel
ComfyUI Node Runs on cloud

🌁 CR Image Grid Panel

Tile a batch into a contact sheet in ComfyUI

By Suzie1Β·Created 3 years agoΒ·Updated 2 years agoΒ· 1,296
🌁 CR Image Grid Panel
  • images
  • image
  • show_help
β—„border_thickness0β–Ί
β—„border_colorβ–Ύβ–Ί
β—„outline_thickness0β–Ί
β—„outline_colorβ–Ύβ–Ί
β—„max_columns5β–Ί
β—„border_color_hex#000000β–Ί

Ran a batch and want all of it in one image - a contact sheet, an XY comparison, a grid of variations you can screenshot and share? CR Image Grid Panel takes a batch of images and tiles them into a single grid, wrapping to a new row at whatever column count you set, with optional borders between cells. Where CR Image Panel handles a fixed one-to-four layout, this is the "throw the whole batch at it" node.

It's a layout node from Comfyroll Studio, the utility pack by Suzie1 and RockOfFire. It composites on the CPU - no model, no GPU.

How it works

Feed it a batch on the images input (a batch of N images, the kind a sampler or a loader produces), tell it how many columns you want, and it arranges them left-to-right, top-to-bottom into one grid image. Borders and outlines draw between the cells so they don't blur together.

The inputs that matter

  • images - the batch to tile. This is the key point: it expects a batch, not a single image. Point it at the batched output you want laid out.
  • max_columns - how many across before it wraps to the next row (default 5). This alone controls the grid shape.
  • border_thickness / border_color - the spacing and color between cells. Set border_color to custom to use the optional border_color_hex; a named color ignores hex.
  • outline_thickness / outline_color - a thin frame around each cell.

Output is a single image plus show_help (a wiki link - leave it dangling).

Installing it

ComfyUI Manager β†’ search Comfyroll Studio β†’ install β†’ restart. Manually:

cd ComfyUI/custom_nodes
git clone https://github.com/Suzie1/ComfyUI_Comfyroll_CustomNodes

then restart. No model files.

Common issues

You gave it one image and got one cell. It tiles whatever's in the batch - if only a single image arrives, that's your grid. Make sure the upstream node is producing a batch.

Uneven counts leave gaps. A batch that doesn't fill the last row will leave the row partly empty; that's expected, not a bug.

Pack fails to load. The Failed to load Graphics nodes + NameError: name 'CR_HalftoneGrid' is not defined console error means a graphics dependency (typically matplotlib) failed to import and took the whole Comfyroll pack offline, this node included. Scroll up to the first traceback, pip install the missing package into ComfyUI's Python, restart.

Category🧩 Comfyroll Studio/πŸ‘Ύ Graphics/🌁 Layout

Inputs (7)

NameTypeDefaultDescription
imagesIMAGEβ€”
border_thicknessINT00–1024β€”
border_colorCOMBO30 options: custom, white, black, red, green, blue, +24
outline_thicknessINT00–1024β€”
outline_colorCOMBO29 options: white, black, red, green, blue, yellow, +23
max_columnsINT50–256β€”
border_color_hexoptSTRING#000000β€”

Outputs (2)

NameTypeDescription
imageIMAGEβ€”
show_helpSTRINGβ€”