How to Fix ComfyUI Cannot Find Model File
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
- Check which folder ComfyUI expects the model in (see the folder structure below)
- Move or copy the model file to the correct folder
- 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 now | What it means | Next step |
|---|---|---|
Value not in list: ckpt_name: 'model-name.safetensors' not in [] | The loader is registered, but no matching checkpoint is visible | Put the checkpoint in models/checkpoints/ or fix model paths |
| A LoRA, VAE, CLIP, ControlNet, or IPAdapter file is named in the error | The workflow is asking for a model asset | Match the file type to the correct models/ subfolder |
The workflow still shows red nodes or unknown class_type values | The node is still missing | Go back to workflow missing nodes |
Startup log says IMPORT FAILED or No module named ... | The plugin backend did not import | Use plugin import failed or No module named errors |
| The file exists but the dropdown is empty | ComfyUI may be scanning a different folder | Check model path not detected |
Missing model, wrong folder, or wrong ComfyUI install?
Use this split before downloading another multi-GB file:
| Symptom | Likely cause | Next action |
|---|---|---|
| File name is shown in the error and you do not have it | The workflow needs a model you have not downloaded | Download the exact file or edit the workflow to use a local equivalent |
| File exists, but in a different model type folder | Wrong folder for the loader | Move it to the folder used by that node type |
| File exists in another ComfyUI folder | You are editing a different install than the one running | Find the active ComfyUI path before moving files |
| File exists in an external drive, but dropdown is empty | extra_model_paths.yaml is missing, stale, or loaded from the wrong location | Fix model paths and restart ComfyUI |
| Dropdown sees the file, but queue still fails | The model family may not match the loader | Check 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.safetensorsFileNotFoundError: Model file not found: models/checkpoints/sdxl_base.safetensorsValueError: 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 inmodels/checkpoints/ - Wrong subfolder: The model is a LoRA but was placed in
checkpoints/instead ofloras/ - 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.yamlis 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 checkpointsEach 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 type | Expected folder |
|---|---|
| Load Checkpoint | models/checkpoints/ |
| Load LoRA | models/loras/ |
| Load VAE | models/vae/ |
| Load ControlNet Model | models/controlnet/ |
| Load CLIP | models/clip/ |
| Load Upscale Model | models/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 type | Typical size |
|---|---|
| SD 1.5 checkpoint | 2-4 GB |
| SDXL checkpoint | 6-7 GB |
| FLUX checkpoint | 12-24 GB |
| LoRA | 10-200 MB |
| ControlNet | 700 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:
| Check | Why |
|---|---|
| The file size looks complete | Browser 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 list | ComfyUI may not rescan every folder immediately |
| The workflow queues past the original loader | The 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
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 AccessDid 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.