> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# TextOverlay - ComfyUI Built-in Node Documentation

> Complete documentation for the TextOverlay node in ComfyUI. Learn its inputs, outputs, parameters and usage.

This node draws text on top of an image or a batch of images. It supports custom text, font size, color, position, alignment, and an optional outline, compositing the text over the original image.

## Inputs

| Parameter   | Description                                                                                | Data Type | Required | Range                             |
| ----------- | ------------------------------------------------------------------------------------------ | --------- | -------- | --------------------------------- |
| `images`    | The input image or batch of images to draw text on.                                        | IMAGE     | Yes      |                                   |
| `text`      | The text string to overlay. Supports newline (`\n`) and tab (`\t`) characters. Default: "" | STRING    | Yes      |                                   |
| `font_size` | Font size as a percentage of the image height. Default: 5.0                                | FLOAT     | Yes      | 0.5 to 50.0                       |
| `color`     | Color of the text. Default: "#ffffff" (white)                                              | STRING    | Yes      |                                   |
| `position`  | Vertical position of the text on the image. Default: "top"                                 | COMBO     | Yes      | "top"<br />"bottom"               |
| `align`     | Horizontal alignment of the text. Default: "left"                                          | COMBO     | Yes      | "left"<br />"center"<br />"right" |
| `outline`   | Draw a black outline around the text. Default: True                                        | BOOLEAN   | Yes      |                                   |

## Outputs

| Output Name | Description                                                           | Data Type |
| ----------- | --------------------------------------------------------------------- | --------- |
| `images`    | The image or batch of 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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TextOverlay/en.md)

***

**Source fingerprint (SHA-256):** `baffaa4ec9d3565e3533673658399271234def8c49e2e4a5f16767ec3f98cb22`