Create editable text reference blocks.
Upload and preview image reference blocks.
Save and open template libraries as JSON files.
Select a specific block from an Output dropdown.
Output the selected text or image to other ComfyUI nodes.
Reorder blocks by dragging them.
Collapse, expand, resize, copy, and delete blocks from the node UI.
Store user-created data in ComfyUI's user directory instead of the extension install folder.

Nodes

Template Reference

Use this node to collect mixed text and image references.

Outputs:

select_text: Text from the selected text block.
select_image: Image from the selected image block.
template_json: Full serialized node state.

Main controls:

Add Textbox: Add a text reference block.
Add LoadImage: Add an image reference block.
Output: Select which block should be sent to the outputs.
Open / Save: Load or save a Template Reference JSON library.

Prompt Template

Use this node to collect reusable prompt templates.

Outputs:

selected_prompt: Text from the selected prompt block.
prompt: Same selected prompt text, provided as a convenience output.
template_json: Full serialized node state.

Main controls:

Add Template: Add a prompt template block.
Output: Select which template should be sent to the text outputs.
none: Output an empty prompt.
Open / Save: Load or save a Prompt Template JSON library.
Image: Show or hide an optional reference image area for each prompt block.

Installation

Clone this repository into your ComfyUI custom_nodes directory:

cd ComfyUI/custom_nodes
git clone https://github.com/Tsubasa109/ComfyUI-TemplateReference.git

Restart ComfyUI after installation.

Storage Location

The extension automatically creates local storage folders under ComfyUI's user directory:

ComfyUI/user/template_reference/prompt_templates/
ComfyUI/user/template_reference/prompt_templates/images/
ComfyUI/user/template_reference/reference_templates/
ComfyUI/user/template_reference/reference_templates/image/

These folders contain user-created JSON libraries and copied reference images.

Notes

Reference images are not embedded into JSON files. The JSON stores image metadata and the extension copies uploaded images into its storage folders.
If a saved image cannot be found, the node keeps the workflow running and returns a small placeholder image while logging a warning.
Runtime storage folders are ignored by Git and should not be committed to the repository.

File Format

All JSON template files are saved as UTF-8 without BOM.
Non-ASCII characters (including Japanese) are stored as-is in the JSON, not as escape sequences.
When opening saved JSON files in an external editor, make sure the editor is set to UTF-8 encoding.

Requirements

ComfyUI

License

Apache License 2.0 (see LICENSE)