❌[DEPRECATED] Image Labeler (old version)
The old Image Labeler — fine to leave in saved workflows, but Labeler 2 supersedes it
- image
- IMAGE
Image Labeler (no "2") is the original version of the Z-Image Power Nodes labeler, and it's now marked deprecated in favor of ImageLabeler2. The honest summary: it still works exactly as it did, and if it's sitting inside a saved workflow, nothing is broken. It's just frozen while its successor carries the improvements.
What it does
Identical job to the current node: feed it an image and a string, and it renders the string as a labeled text box on the image, then outputs the result. Same controls as ImageLabeler 2 - text, text_color and background_color as hex strings, font_name, font_size (8–256, auto-adjusted to image height), label_position (default bottom_right), label_padding (−1 = automatic), and min_label_width / min_label_height floors. Output is the labeled IMAGE.
The one meaningful difference between the two versions is that ImageLabeler 2 adds an enable_label master switch so you can bypass the label without clearing all your settings. That's the entire reason the author deprecated this one - it's not a bug fix or a rewrite, it's a convenience toggle plus the standard "old version" marker.
Inputs & outputs
image(IMAGE) - input to label.text,text_color,background_color,font_name,font_size,font_scale,label_position,label_padding,min_label_width,min_label_height- same settings as the current node.- Output:
IMAGE.
Install
It ships in the same pack, so the install is the pack install:
cd ComfyUI/custom_nodes
git clone https://github.com/martin-rizzo/ComfyUI-ZImagePowerNodes
Restart ComfyUI (or ComfyUI Manager, search "Z-Image Power Nodes"). No pip dependencies.
Use it or not?
If you're building anything new, use ImageLabeler2 - it's the same thing plus a bypass switch, and the deprecated tag is the author telling you where the maintenance budget goes. If you've got an old workflow referencing this one, you can leave it running; "deprecated" in this pack means frozen, not broken. Just know that any future polish (new fonts, better auto-scaling, the label-on/off toggle) lands on the 2 version, and the two behave identically for the settings they share. When you eventually touch that old workflow anyway, the swap is a two-minute find-and-replace.
Inputs (11)
| Name | Type | Default | Description |
|---|---|---|---|
| image | IMAGE | Input image to which the label will be added. | |
| text | STRING | Text to be displayed in the label. | |
| text_color | STRING | #FF0000 | Color of the label text in hexadecimal format (e.g. #FFFFFF for white). |
| background_color | STRING | #FFFFFF | Background color of the label in hexadecimal format (e.g. #000000 for black). |
| font_name | COMBO | roboto_slab | The font to be used for the label text. |
| font_size | INT | 648–256 | Size of the font used for the label text, the final size will be adjusted automatically in relation to the image height. |
| font_scale | COMBO | none | Position of the label on the image, specifying the corner or edge alignment. |
| label_position | COMBO | bottom_right | Position of the label on the image, specifying the corner or edge alignment. |
| label_padding | INT | -1-1–100 | Padding around the label text, measured in pixels. Set this value to -1 for automatic padding adjustment based on font size. |
| min_label_width | INT | 0 | Minimum width of the label area in pixels, ensuring the label has enough width even if the text is so short. |
| min_label_height | INT | 0 | Minimum height of the label area in pixels, ensuring the label has enough height even if the font is so small. |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| IMAGE | IMAGE | Output image with the added label containing the specified text. |