LogoWonderful Launcher
  • Home
  • Pricing
  • Docs
  • Download
Safetensors FolderSave WorkflowsWorkflow Missing NodesModel Not FoundModel Path Not Detected
Models & Workflows

How to Fix ComfyUI Cannot Find Model File

Partially verifiedLast verified 2026-06-29

Fix ComfyUI errors when it cannot find a model, checkpoint, LoRA, or other file — wrong path, missing download, or incorrect folder structure.

Community Knowledge

This page is based on common ComfyUI troubleshooting patterns and has not been fully tested across all environments. Back up your environment before changing packages.

If ComfyUI shows an error like "Model not found", "Checkpoint not found", or a node has an empty model dropdown, the model file is not in a location that ComfyUI can see.

This is rarely a corrupted file — it is almost always a path problem. The file exists somewhere on your disk, but ComfyUI is looking in a different folder.

In the 30-day Wonderful Launcher telemetry window ending June 29, 2026, missing models were detected on 27 installs and resolved on 17 installs. That makes missing model placement one of the most useful public docs topics for existing users: once nodes load correctly, the next blocker is often the model asset.

Fast answer

  1. Check which folder ComfyUI expects the model in (see the folder structure below)
  2. Move or copy the model file to the correct folder
  3. Refresh the ComfyUI browser page or restart ComfyUI

Case-review boundary: model file or something else?

Agent repair cases often reach this page after missing custom nodes are fixed. That is the right handoff only when ComfyUI now recognizes the node but cannot find the model asset the node selected.

What you see nowWhat it meansNext step
Value not in list: ckpt_name: 'model-name.safetensors' not in []The loader is registered, but no matching checkpoint is visiblePut the checkpoint in models/checkpoints/ or fix model paths
A LoRA, VAE, CLIP, ControlNet, or IPAdapter file is named in the errorThe workflow is asking for a model assetMatch the file type to the correct models/ subfolder
The workflow still shows red nodes or unknown class_type valuesThe node is still missingGo back to workflow missing nodes
Startup log says IMPORT FAILED or No module named ...The plugin backend did not importUse plugin import failed or No module named errors
The file exists but the dropdown is emptyComfyUI may be scanning a different folderCheck model path not detected

Missing model, wrong folder, or wrong ComfyUI install?

Use this split before downloading another multi-GB file:

SymptomLikely causeNext action
File name is shown in the error and you do not have itThe workflow needs a model you have not downloadedDownload the exact file or edit the workflow to use a local equivalent
File exists, but in a different model type folderWrong folder for the loaderMove it to the folder used by that node type
File exists in another ComfyUI folderYou are editing a different install than the one runningFind the active ComfyUI path before moving files
File exists in an external drive, but dropdown is emptyextra_model_paths.yaml is missing, stale, or loaded from the wrong locationFix model paths and restart ComfyUI
Dropdown sees the file, but queue still failsThe model family may not match the loaderCheck whether the workflow needs checkpoint, LoRA, VAE, CLIP, ControlNet, diffusion, or GGUF

Do not declare a missing-node repair "fixed" just because red nodes disappear. Queue or validate the workflow once more so the next missing model file becomes visible.

What the errors look like

Error: Checkpoint not found: v1-5-pruned-emaonly.safetensors
FileNotFoundError: Model file not found: models/checkpoints/sdxl_base.safetensors
ValueError: No checkpoint found in models/checkpoints/

Official ComfyUI model troubleshooting also shows validation errors like:

Prompt outputs failed validation:
CheckpointLoaderSimple:
- Value not in list: ckpt_name: 'model-name.safetensors' not in []

Or the model dropdown in a node simply shows no options.

Why it happens

  • Wrong folder: The model file is in models/ but needs to be in models/checkpoints/
  • Wrong subfolder: The model is a LoRA but was placed in checkpoints/ instead of loras/
  • Not downloaded yet: The model file was never downloaded or the download was incomplete
  • Custom model path not configured: You have models in a separate drive but extra_model_paths.yaml is not set up
  • Filename mismatch: The workflow expects a specific filename that does not match what you downloaded
  • Symlinks or shortcuts: Windows shortcuts (.lnk files) are not the same as the actual model file

ComfyUI default model folder structure

ComfyUI/
└── models/
    ├── checkpoints/      ← SD 1.5, SDXL, FLUX checkpoints (.safetensors, .ckpt)
    ├── loras/            ← LoRA files (.safetensors)
    ├── vae/              ← VAE models
    ├── clip/             ← CLIP models
    ├── controlnet/       ← ControlNet models
    ├── upscale_models/   ← Upscaling models (ESRGAN, etc.)
    ├── embeddings/       ← Textual inversion embeddings
    ├── clip_vision/      ← CLIP vision models (for IP-Adapter)
    ├── ipadapter/        ← IP-Adapter models
    ├── unet/             ← Standalone UNet models (FLUX, etc.)
    └── sams/             ← Segment Anything Model checkpoints

Each model type goes in a specific subfolder. ComfyUI will not find a checkpoint if it is in the wrong subfolder.

Step-by-step fix

Step 1: Identify what type of model is missing

The error message or node type tells you which folder to check:

Node typeExpected folder
Load Checkpointmodels/checkpoints/
Load LoRAmodels/loras/
Load VAEmodels/vae/
Load ControlNet Modelmodels/controlnet/
Load CLIPmodels/clip/
Load Upscale Modelmodels/upscale_models/

Step 2: Check if the file is there

dir ComfyUI\models\checkpoints\

Replace checkpoints with the relevant subfolder. If the file is not there, download it or move it from wherever it was saved.

Step 3: Check for incomplete downloads

Model files are large. An incomplete download will have a much smaller file size than expected:

Model typeTypical size
SD 1.5 checkpoint2-4 GB
SDXL checkpoint6-7 GB
FLUX checkpoint12-24 GB
LoRA10-200 MB
ControlNet700 MB - 2.5 GB

If the file is much smaller, delete it and download again.

Step 4: Use extra_model_paths.yaml for external folders

If your models are on a different drive, copy or rename extra_model_paths.yaml.example to extra_model_paths.yaml, then edit the file in the ComfyUI root directory:

my_models:
    base_path: D:/AI/models/
    checkpoints: checkpoints/
    loras: loras/
    vae: vae/
    controlnet: controlnet/

Restart ComfyUI after editing this file. ComfyUI will scan both the default models/ folder and your external folders.

If you launch ComfyUI with a custom config file path, confirm the same process loads that config. Recent ComfyUI builds also expose an --extra-model-paths-config option for loading one or more extra model path files, but most users should start with extra_model_paths.yaml in the ComfyUI folder.

Step 5: Fix filename mismatches

If a workflow expects a model named sd_xl_base_1.0.safetensors but your file is named sdxl_base.safetensors, either:

  • Rename your file to match the workflow expectation
  • Edit the workflow to select your filename from the dropdown

When not to run pip install blindly

Model-not-found errors are never fixed by installing Python packages. Do not run pip install when the problem is a missing or misplaced file. The fix is always about file placement, not package management.

Verification before you call it fixed

After moving or downloading a model file, verify these four things:

CheckWhy
The file size looks completeBrowser or proxy failures can leave partial files
The file is in the subfolder used by that loader.safetensors alone does not decide the folder
You restarted ComfyUI or refreshed the relevant model listComfyUI may not rescan every folder immediately
The workflow queues past the original loaderThe next error may reveal another missing model or a model-family mismatch

How Wonderful Launcher can help

Wonderful Launcher helps manage model paths. It helps detect where your models are stored, assists with configuring extra_model_paths.yaml, and provides clear feedback when a model file is missing or in the wrong location.

Download Wonderful Launcher — it's free and simplifies model management.

Related errors

  • Where ComfyUI Stores Checkpoints
  • Model Path Not Detected
  • Where to Put Safetensors in ComfyUI
  • Install Models in ComfyUI
  • Workflow Missing Nodes
  • ComfyUI Common Issues

Source References

  • ComfyUI GitHub
  • Official ComfyUI model troubleshooting
  • ComfyUI extra_model_paths.yaml.example

Start free with Wonderful Launcher if this affects your real ComfyUI environment. If the repair is blocking work, Agent Access is the paid guided path; credits are for image generation and metered tools.

Download Wonderful LauncherSee Agent Access

Did this fix your issue?

Your answer helps prioritize verified ComfyUI repairs.

Workflow Missing Nodes

Fix ComfyUI workflows with missing nodes, empty nodes, unknown pack messages, clean library entry point errors, ControlNetApplyAdvanced class_type issues, and node id has no class_type errors.

Model Path Not Detected

Fix ComfyUI model path not detected, extra_model_paths.yaml not loading models, path format errors, and missing model dropdowns step by step.

Table of Contents

Case-review boundary: model file or something else?
Missing model, wrong folder, or wrong ComfyUI install?
What the errors look like
Why it happens
ComfyUI default model folder structure
Step-by-step fix
Step 1: Identify what type of model is missing
Step 2: Check if the file is there
Step 3: Check for incomplete downloads
Step 4: Use extra_model_paths.yaml for external folders
Step 5: Fix filename mismatches
When not to run pip install blindly
Verification before you call it fixed
How Wonderful Launcher can help
Related errors
Source References