Grid Display And Save ♾️Mixlab
Preview and save a labeled region layout
- grids
- image
Mixlab has a family of nodes built around a custom _GRID type - regions defined on a canvas, used mainly for regional-prompt layouts feeding the pack's GLIGEN-based node (the same system its SplitImage node produces regions for). Grid Display And Save is that system's checkpoint node: before you burn GPU time running a full regional-prompt generation, this lets you see where each region actually landed and save that visualization to disk.
How it works
You feed it your regions (grids), a matching set of labels, and the base image they were defined against, plus a filename prefix. It draws the labeled boxes over the image and saves the result - a sanity check, not a generation step. It's marked as an output node with no data outputs, so it's meant to sit at the end of a layout-checking branch, not feed into anything further.
The inputs and outputs that matter
grids(_GRID, required) - the regions to visualize. This is Mixlab's own type, produced by sibling nodes likeSplitImage,GridInput, orCenterImage.labels(STRING, multiline, default empty, required) - the names for each region. These should line up one-per-region with whatever you're feeding intogrids, or the labeling will look mismatched.image(IMAGE, required) - the base image the layout was defined against.filename_prefix(STRING, defaultmixlab/grids, required) - where the saved visualization goes.
No outputs - this is a terminal node.
How to install it
Ships with the Mixlab pack.
- ComfyUI Manager: search
comfyui-mixlab-nodes, install, restart. - Manual:
cd ComfyUI/custom_nodes && git clone https://github.com/shadowcz007/comfyui-mixlab-nodes.git, install requirements (install.baton Windows, or../../../python_embeded/python.exe -s -m pip install -r requirements.txt), restart.
No model downloads for this node.
Common issues & troubleshooting
The grids input won't connect. _GRID is Mixlab-specific - it only accepts output from the pack's own layout nodes (SplitImage, GridInput, CenterImage), not a generic list of images or crop coordinates. If you're trying to feed it something from another pack, that connection isn't going to work.
Labels don't match up with the right regions. Check the count and order of your labels entries against however many regions grids is actually carrying - a mismatch here is the most common cause of a visualization that looks scrambled.
Nothing seems to save. Since this is an output-only node with no data ports, confirm you actually ran the graph rather than just previewing it, and check filename_prefix points somewhere you can find in your output folder.
Inputs (4)
| Name | Type | Default | Description |
|---|---|---|---|
| labels | STRING | — | |
| grids | _GRID | — | |
| image | IMAGE | — | |
| filename_prefix | STRING | mixlab/grids | — |
Outputs (0)
No outputs