comfyui-node-outputs

Return data and UI previews from ComfyUI nodes using NodeOutput and ui helpers.

265|28|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/jtydhr88/comfyui-custom-node-skills --skill comfyui-node-outputs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comfyui-node-outputs
Source: https://github.com/jtydhr88/comfyui-custom-node-skills/tree/main/plugins/comfyui-custom-nodes/skills/comfyui-node-outputs
Command: npx skills add https://github.com/jtydhr88/comfyui-custom-node-skills --skill comfyui-node-outputs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Nodes in ComfyUI often need to return not just raw data but also dynamic visual feedback. This Skill enables nodes to return both data and rich UI previews, simplifying result interpretation and downstream handling.

Core Features & Use Cases

  • Supports multiple NodeOutput variants for data-only, UI-only, and data+UI responses (e.g., images, text, audio, and more).
  • Integrates with UI preview helpers (PreviewImage, PreviewMask, PreviewAudio, PreviewText, etc.) and Saved results for persistent outputs.
  • Enables seamless use in both V3 workflows and legacy patterns by providing clear guidelines for defining schemas and execute methods.

Quick Start

Create a node that outputs a data value and a UI preview using NodeOutput.

Frequently Asked Questions about comfyui-node-outputs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I return data and image previews from a ComfyUI node?

To return data and image previews from a ComfyUI node, assemble outputs using io.NodeOutput combined with ui.* helpers like PreviewImage within the define_schema and execute methods to pass both raw data and visual feedback.

What is the difference between temporary UI previews and saved image results in ComfyUI?

Temporary UI previews display dynamic visual feedback during execution, while saved image results provide persistent outputs in permanent storage. Both are handled using NodeOutput variants and UI helpers across V3 workflows.

Can I output text and audio previews alongside data in ComfyUI V3 workflows?

Yes, you can output text and audio previews in ComfyUI V3 workflows by integrating specific UI helpers like PreviewText and PreviewAudio with NodeOutput to return data-only, UI-only, or combined responses.

How do I assemble node outputs using io.NodeOutput and ui helpers in ComfyUI?

You assemble node outputs by defining schemas and structuring the execute method to combine io.NodeOutput for raw data passing with ui.* helpers for rendering rich visual previews, supporting V3 workflows and legacy patterns.

Does ComfyUI support returning dynamic visual feedback without saving files permanently?

Yes, ComfyUI supports returning dynamic visual feedback without permanent storage by using UI-only NodeOutput variants and preview helpers like PreviewImage or PreviewMask to render temporary results directly in the workflow UI.

Why do my ComfyUI node outputs only return raw data without UI previews?

ComfyUI node outputs lack UI previews if the execute method only returns raw data without integrating ui.* helpers. Combine NodeOutput with UI preview components to send both data and visual rendering instructions.