Nodes reference

Five nodes, all under the StyleRef category. Four work without an account.

Looking for extraction? Turning an image into a style happens on styleref.io  — where you can preview and refine the result — and the style then loads here by its share slug or id.

Loading one of your own styles gives you what you last generated on styleref.io, so edits reach the graph once you press Generate there. A style you have never generated stops the node with that instruction spelled out — generate it once on the web and re-run. Gallery styles always load.

StyleRef Load

Fetches a style and outputs it as a STYLEREF_STYLE object. After a successful load, the node body shows what loaded — name, author, section count, and the palette.

Inputs

Outputs

The Search styles… button opens a picker with live search, a category filter and thumbnails. Choosing a style fills style_ref.

The picker has two sections, each showing 8 styles at a time with its own ‹ Prev / Next ›: your own library on top (when signed in), then the gallery below. The search box filters both — typing narrows your own styles by name as well as searching the gallery.

The dropdown next to it picks what the lower section shows:

A style of your own that you have never generated is marked not generated. You can still pick it, but it won’t load until you generate it once on styleref.io.

The ↻ Refresh style button re-downloads the style once on the next queue — use it after editing the style on styleref.io, without touching use_cache.

Want the style as a STYLE.md document? That’s a target on Apply, same as the other formats.

Loading your own private style requires sign-in. If your style has never been generated, the server asks you to open it on styleref.io and Generate it first — loading always uses the last generated version.

StyleRef Apply

Composes your subject with the style into ready-to-use prompts. The node body previews the composed positive with a rough token estimate, so you can see what StyleRef produced before the sampler runs.

Inputs

Outputs

The negative output is the style’s own guardrails plus your extra_negative — nothing injected. It arrives negative-channel ready: terse, comma-separated visual terms (artifacts to avoid, avoided visuals, colors, layouts), with directive words like “avoid” stripped — a negative encoder negates the literal tokens, so “avoid X” would negate the word “avoid”. Text-voice constraints (avoided words) stay out of image negatives. If you want generic quality negatives, put them in extra_negative where they stay visible.

About targets

The list is exactly the web app’s copy-box format list, in the same order — a style compiles to the same thing here as on styleref.io.

For the sampler in your graph, use:

• flux — natural-language phrasing for FLUX models
• diffusion — tag-weighted output for SDXL, SD1.5, DALL·E-class models

The rest are for copying out of ComfyUI (the node shows a warning badge if one feeds a CLIP encoder):

• ai_tools — prose for ChatGPT, Gemini, and text LLMs
• style_md — the portable STYLE.md document, verbatim (subject ignored)
• midjourney — Midjourney-phrased prompt text
• json — the structured spec, verbatim (subject ignored)

These are the same formats as StyleRef’s REST API and MCP tools; ai_tools = the API’s default format, style_md = stylemd.

Each style is compiled server-side for the target you choose, so switching targets rephrases the style rather than reusing one generic block of text.

Attribution is a separate output, not part of the prompt, so it never reaches the text encoder as tokens.

StyleRef Facets

Splits a style into its sections, for graphs that need more than a prompt string — IPAdapter weights, conditioning regions, per-section text encoders. It’s a tall node by design, and it mirrors the style board one-to-one: the outputs are exactly the style schema’s section list, named as you see them on styleref.io — nothing derived, nothing invented.

Inputs

Outputs

One string output per schema section, in schema order: output_format, container_boundary, mood_personality, colors, typography, light_shadow, spatial_hierarchy, surface_material, motion, shape_language, stroke_system, voice_language, post_processing, background_environment, artistic_mediums, ui_web, references, guardrails — each rendered as readable field: value lines — plus custom_style_item_1 … custom_style_item_6 individually (empty when unset).

(The assembled negative prompt is Apply’s negative output; the inspiration images are the Reference Images node.)

StyleRef Reference Images

The style’s inspiration images as a ComfyUI IMAGE batch — the visual half of the style, for IPAdapter, reference-only ControlNet, or just a Preview Image next to your graph. Prompts say what the style reads like; these show what it looks like.

Inputs

Outputs

A style with no inspiration images errors with a clear message — add images on styleref.io, or disconnect the node.

Deliberately, inspiration images are not embedded in Apply’s prompts: a sampler can’t fetch a URL out of prompt text, so image conditioning belongs here, as images.

StyleRef Login

A helper, not part of the data path, with no widgets to configure. The node shows your current status and carries three buttons — no queueing needed:

• Status — shows ✔ signed in or signed out; click it to re-check. It also re-checks itself when the tab regains focus.
• Sign in (browser) — opens styleref.io in your browser for approval.
• Sign out — removes the stored credentials.

Queueing the node prints the full status text in the node body — including the token instructions on headless installs. No frontend at all? npx styleref login signs in the same credentials file the node uses.

Outputs

See login & credits, especially if ComfyUI runs on a remote machine.

The STYLEREF_STYLE type

Load, Apply, Facets, and Reference Images pass a STYLEREF_STYLE object between them rather than raw text. It carries the full structured style — every section and field — so Facets can read the palette even though Apply only produced prompt text.

You can connect one Load to as many Apply, Facets, and Reference Images nodes as you want.

A note on reproducibility

A workflow stores only the style reference, not the style itself. If the style is edited on styleref.io later, re-running the workflow compiles the updated style — your prompts can change even though the graph didn’t. Keep use_cache on for stability within a session; for a permanent record of what a run used, save Apply’s positive/negative outputs (the templates attach Preview Any nodes for exactly this).