Skip to main content

ComfyUI "the following node types were not found" — fix missing custom nodes

Also seen as: "When loading the graph the following node types were not found", "node type not found", "undefined node type", "red nodes ComfyUI"

Direct answer

How do I fix "missing custom nodes (node type not found)"?

This means the workflow uses a custom node that is not installed in your ComfyUI — the graph references a node class ComfyUI has not registered, so the node shows up red and the graph will not run. It is a missing node package, not a broken workflow. (It is different from a ModuleNotFoundError, which is a node that IS installed but is missing a Python dependency.)

Key facts

  • iThe custom node the workflow needs was never installed — the most common case.
  • iThe node is installed but under a renamed or forked class the workflow does not reference.
  • iThe node is installed but pinned to a commit older than the one that added that class, so it never registers.
  • iA frontend-only virtual node (some GetNode/SetNode setups) was exported without its backing extension.

Next step

  1. 1In ComfyUI Manager, run "Install Missing Custom Nodes" — it maps the red nodes to their repos and installs them, then restart.
  2. 2If Manager cannot find it, search the exact node-class name on GitHub or the ComfyUI registry, git clone the repo into custom_nodes/, install its requirements.txt, and restart.
  3. 3If the node IS installed, update it (or pin forward) until every referenced class registers — a too-old pin will not have the class.
  4. 4Deploying to a headless/cloud box with no Manager UI? Paste the workflow into a checker that resolves every node to its repo + install command so nothing is missing at boot.

Not a fit when

  • If the node installs but the error changes to ModuleNotFoundError, that is a different problem — the node is present but a Python package it imports is missing; reinstall its requirements.
  • "Install Missing Custom Nodes" cannot resolve a node deleted from GitHub or renamed with no redirect — you will need a maintained fork.

Not sure this workflow will run before you rent a GPU?

Paste your ComfyUI workflow JSON into the free checker — it flags missing nodes, model requirements, and the VRAM/GPU you actually need. No signup.

Check my workflow freeSee GPU pricing

Other ComfyUI errors

Fix

GPU Memory Exhausted

Fix

Model Not Found

Fix

Missing Python Package

Fix

Disk Space Exhausted

Fix

Gated Model Access

Fix

MetadataIncompleteBuffer / HeaderTooLarge (truncated safetensors)

Frequently Asked Questions

What causes "missing custom nodes (node type not found)" in ComfyUI?

The custom node the workflow needs was never installed — the most common case.

How do I fix "missing custom nodes (node type not found)"?

In ComfyUI Manager, run "Install Missing Custom Nodes" — it maps the red nodes to their repos and installs them, then restart. If Manager cannot find it, search the exact node-class name on GitHub or the ComfyUI registry, git clone the repo into custom_nodes/, install its requirements.txt, and restart.