ComfyUI Node

Create Extra Metadata

The tiny node that stamps your own labels onto every render

By watarika·Created 2 years ago·Updated about a month ago· 10
Create Extra Metadata
  • extra_metadata
  • EXTRA_METADATA
key1
value1
key2
value2
key3
value3
key4
value4

ComfyUI's Save Image already buries your whole generation recipe in the file's metadata - prompt, sampler, model, the lot. What it can't do is let you add anything of your own. CreateExtraMetadata is the missing sticky note: a tiny node that builds your own Key: Value pairs and hands them to the Send-to-Eagle nodes in this pack, which write them into the PNGInfo and, if you want, into Eagle's tags and notes.

How it works

The node is deliberately dumb, and that's the point. It collects up to four key/value string pairs (key1/value1 through key4/value4) into a dictionary and outputs that as a single EXTRA_METADATA object. Feed that into the extra_metadata input on either Send node and each pair becomes a line in the embedded metadata. One quirk worth knowing before it bites you: commas inside values get swapped for / when written to the file, because the parameters text block treats commas as field separators. "characters: foo, bar" lands as characters: foo/bar.

The inputs

Inputs and outputs are short enough to list in full. key1 and value1 are required; key2key4 plus their values are optional. There's also an extra_metadata input of the same type - chain one CreateExtraMetadata's output into the next one's extra_metadata input and you can stack past four pairs. The single output is EXTRA_METADATA. That's the whole node.

What you'd use it for

So what do you actually do with it? The pairs become searchable facts in Eagle. Tracking a series? Set key1 = series, value1 = october-project. The Extended node's custom_tag_pattern can reference any key you define, so series becomes an Eagle tag you can filter on later - and the pair is burned into the file's PNGInfo either way, so the info survives even if the image never touches Eagle. Common uses: character name, model family, client, upscaler, whether an image passed review.

Install

Install comes free: it ships inside ComfyUI-SendToEagle-w-Metadata, so there's no separate step.

cd <ComfyUI>/custom_nodes
git clone https://github.com/watarika/ComfyUI-SendToEagle-w-Metadata.git

Then restart ComfyUI (or install the pack via ComfyUI Manager - search "Send to Eagle"). The pack's only Python dependency is piexif, which gets pulled in for the JPEG/WebP side of things; there's nothing to download model-wise.

It won't change your life. But it's the difference between "which render was this, again?" archaeology and knowing exactly what you made, in a form you can search. Wire one up once and forget it.

CategorySendToEagle

Inputs (9)

NameTypeDefaultDescription
key1STRING
value1STRING
key2optSTRING
value2optSTRING
key3optSTRING
value3optSTRING
key4optSTRING
value4optSTRING
extra_metadataoptEXTRA_METADATA

Outputs (1)

NameTypeDescription
EXTRA_METADATAEXTRA_METADATA