TextOverlay - ComfyUI Built-in Node Documentation - ComfyUI

This node draws text on top of an image or a batch of images. It creates a text overlay with customizable font size, color, position, alignment, and an optional outline, then composites the text onto the original images.

Inputs

Parameter	Description	Data Type	Required	Range
`images`	The input image or batch of images to draw text on	IMAGE	Yes
`text`	The text to overlay on the image (default: ""). Supports multiple lines; the `\n` and `\t` escape sequences are converted to newlines and tabs, and the text is automatically wrapped to fit within the image width.	STRING	Yes
`font_size`	Font size as a percentage of the image height (default: 5.0)	FLOAT	Yes	0.5 to 50.0 (step 0.5)
`color`	Color of the text (default: “#ffffff”)	STRING	Yes
`position`	Vertical position of the text on the image (default: “top”)	COMBO	Yes	”top" "bottom”
`align`	Horizontal alignment of the text (default: “left”)	COMBO	Yes	”left" "center" "right”
`outline`	Draw a black outline around the text (default: True)	BOOLEAN	Yes

Note: If text is empty or contains only whitespace, the node returns the input images unchanged. The same text overlay is applied to every image in the batch.

Outputs

Output Name	Description	Data Type
`images`	The input images with the text overlay composited on top	IMAGE

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): baffaa4ec9d3565e3533673658399271234def8c49e2e4a5f16767ec3f98cb22