⭐ Star Metadata Saver Option
Five little text boxes that make your saved images carry their own story
- save_options
This node does absolutely nothing by itself, and that's the whole point. Star Metadata Saver Option is a config-bundle node: five multiline text fields that hand a little dictionary of key/value pairs to ⭐ Star Save Image+, which then embeds them into every PNG, JPG or WEBP it writes. It's the answer to the eternal "what the hell was I thinking when I made this" problem - you get to bake the prompt, the tags, the version, the date, the seed, whatever you want, straight into the file.
If you've ever downloaded a ComfyUI workflow PNG and marvelled that all the wiring survived the trip, that's the metadata you're now writing yourself. The pack's whole philosophy is "fewer wires, better defaults," and this node is the metadata half of that deal: instead of one giant Save node covered in fields you never touch, you get a small dedicated panel that only does metadata, and a Save node that stays clean.
How it works
You type text into StarMetaData 1 through StarMetaData 5 - all STRING, all multiline, all defaulting to empty. The node packs whatever you filled in into an options bundle and emits it as a single save_options output of type STAR_SAVE_OPTIONS. That output is meant for exactly one socket: the options input on ⭐ Star Save Image+. Wire it up once and every image that Save node produces carries your five fields.
Fields you leave empty are simply skipped - no empty keys polluting your metadata. That's a nice touch, because it means you can keep a five-field template node around and only populate what matters for a given run. It also means the node works as a passive rider in your workflow: change a field, re-run, the saved files update. No rerouting.
The inputs that actually matter
Honestly, all five inputs are the same shape, so there's not much to choose from:
- StarMetaData 1–5 - your custom values. Use them for anything you want to survive in the file: the positive prompt you can't reproduce, a negative-prompt note, the LoRA list, a customer name, a "draft vs final" flag.
The single output, save_options, is the only thing that matters for wiring. It's a STAR_SAVE_OPTIONS type, so it will only connect to Star Save Image+'s options input - ComfyUI won't let you plug it into anything else, which keeps beginners from miswiring it.
Install
It's part of the Starnodes2024/ComfyUI_StarNodes pack, so install the pack, not this node:
cd ComfyUI/custom_nodes
git clone https://github.com/Starnodes2024/ComfyUI_StarNodes
cd ComfyUI_StarNodes
pip install -r requirements.txt
Restart ComfyUI, double-click the canvas, and search star. (Or use ComfyUI Manager and search "Starnodes" - the README's recommended path.) There are no extra dependencies for this node; if a package is missing the pack just skips the affected node and prints what to install in the console.
Where people get burned
The most common mistake is expecting the metadata to appear without the partner node. This node only builds the options - if you don't connect save_options into ⭐ Star Save Image+'s options socket, nothing gets embedded. And note the pack's Save Image+ deliberately writes no workflow data on its own; the five StarMetaData fields are your channel for custom info. If you specifically want a workflow graph embedded so someone can drag the PNG back onto their canvas, pair this with the standard ComfyUI Save Image instead - or reach for ⭐ Star Meta Injector, which copies workflow metadata from an existing file onto a new image.
Inputs (5)
| Name | Type | Default | Description |
|---|---|---|---|
| StarMetaData 1 | STRING | Custom metadata value 1 (embedded in saved images). | |
| StarMetaData 2 | STRING | Custom metadata value 2 (embedded in saved images). | |
| StarMetaData 3 | STRING | Custom metadata value 3 (embedded in saved images). | |
| StarMetaData 4 | STRING | Custom metadata value 4 (embedded in saved images). | |
| StarMetaData 5 | STRING | Custom metadata value 5 (embedded in saved images). |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| save_options | STAR_SAVE_OPTIONS | Connect to the 'options' input of ⭐ Star Save Image+. |