Get Reference

Reference images are the workflow value everyone wants to switch per profile and the one the typed Set/Get nodes can't carry - they're IMAGE tensors, not scalars. Get Reference is WorkflowX's node for that: it routes a reference object from a Set Reference node per selected config, and adds something the Relay family doesn't have: an independent mute per Get, so one consumer can be switched off without affecting its siblings.

The use case is the one that bites everyone building multi-profile workflows: same graph, but profile A inpaints from reference A, profile B uses no reference at all, and profile C reuses A. With Set/Get Reference you get all three without rebuilding the graph or dragging a different image in by hand.

How it works

Set Reference publishes any object (wildcard type) under a key, always passing its local value through, plus a mute toggle. Get Reference asks for the key and resolves the selected profile's object, or its directly connected fallback value.

The interesting bit is the mute semantics, which the pack implements with ComfyUI's native mute. When a Set Reference has mute on, every Get Reference with the same key is omitted from the API prompt - like manually muting each one. When a Get Reference has its own mute on, only that Get is omitted, and its siblings keep running. So the Set's mute is "switch this whole reference line off per profile," while each Get's mute is a per-consumer override. Set Reference's output remains usable directly in either state, and muting one Get doesn't touch the others.

Inputs and outputs

• key (STRING) - exact match against the Set Reference key.
• mute (BOOLEAN) - mutes this Get's branch when true.
• set_mute (BOOLEAN) - mirrors/coordinates with the Set's mute state.
• value (wildcard, optional) - fallback object for configs without a matching Set.
• Output: value (wildcard) - the routed reference.

Install

Part of WorkflowX-Configurator. ComfyUI Manager → search WorkflowX Configurator, or:

cd ComfyUI/custom_nodes
git clone https://github.com/haroonaslam/WorkflowX-Configurator

Restart ComfyUI, hard-refresh the browser. No extra Python dependencies.

Common issues

• "No Reference value found for key 'x'." - no matching Set Reference in an Active group and no fallback connected. Fix the key or wire the fallback.
• The whole reference line vanished. Check the Set Reference's mute flag - when it's on, all Gets on that key are omitted.
• Only one consumer disappeared. That's the Get's own mute doing its job. If it's surprising, check which Get you muted, not the Set.

This is a slightly deeper node than the typed Gets, and the mute model takes a minute to click. But it's also one of the pack's more thoughtful features - reference routing plus per-branch muting is exactly the fiddly thing you'd otherwise hand-manage. The pack is young, so lean on the example workflows in the repo when the mute behavior surprises you.