CreateBoundingBoxes - ComfyUI Built-in Node Documentation

This node provides a canvas interface for drawing bounding boxes around objects or text regions in an image. It outputs the bounding box coordinates in pixel space, structured element data compatible with Ideogram prompt formatting, and a preview image showing the drawn boxes with labels and color palettes.

Inputs

Parameter	Description	Data Type	Required	Range
`background`	Optional image used as background in the canvas and preview.	IMAGE	No	-
`bboxes`	Bounding boxes, elements, or a JSON string to initialize the canvas. A new upstream value initializes the canvas; edits made on the canvas take priority and are kept until the upstream value changes again.	BOUNDING_BOX, ARRAY, STRING	No	-
`width`	Width of the canvas and the pixel grid for the bounding boxes (default: 1024).	INT	Yes	64 to 16384 (step: 16)
`height`	Height of the canvas and the pixel grid for the bounding boxes (default: 1024).	INT	Yes	64 to 16384 (step: 16)
`editor_state`	Draw bounding boxes and set each box type, text, description, color palette. Start with background element first and foreground last.	BOUNDING_BOXES	Yes	-
`last_incoming`	Internal state managed by the canvas: the upstream bboxes value that last initialized it. Leave empty to re-initialize the canvas from the bboxes input on the next run.	BOUNDING_BOXES	No	-

Outputs

Output Name	Description	Data Type
`preview`	An RGB image showing the canvas with all bounding boxes rendered, including labels, color palette swatches, and descriptive text.	IMAGE
`bboxes`	A list of bounding boxes in pixel coordinates, with each box containing x, y, width, and height values.	BOUNDING_BOX
`elements`	A structured array of element objects, each containing type, bounding box coordinates (normalized 0-1000), text (for text type), description, and color palette.	ARRAY

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): dc5545dffefdccf14f3919ff4d9966dbfd1a497dcd64e1863556d5728659ee94

​Inputs

​Outputs

Inputs

Outputs