The definitive folder structure guide for ComfyUI
#Overview
Model folder confusion is the #3 most common problem on Reddit. This guide shows you exactly where every file type belongs.
One simple rule: Every model type has its own specific folder. Put files in the wrong place = ComfyUI won't see them.
#๐ Complete Folder Structure
#๐ฏ Most Common Files & Where They Go
Checkpoints (Base Models)
File types: .safetensors, .ckpt
Examples:
- โ
v1-5-pruned-emaonly.safetensors(SD 1.5) - โ
sd_xl_base_1.0.safetensors(SDXL) - โ
flux1-dev.safetensors(Flux)
Location:
How to use: Load with the "Load Checkpoint" node in ComfyUI
LoRAs
File types: .safetensors, .pt
Examples:
- โ
add_detail.safetensors - โ
anime_style_lora.safetensors - โ
photorealistic_face.safetensors
Location:
How to use: Load with "Load LoRA" node
โ ๏ธ Critical: LoRAs MUST match your base model:
- โSD 1.5 LoRA โ SD 1.5 checkpoint
- โSDXL LoRA โ SDXL checkpoint
- โFlux LoRA โ Flux checkpoint
VAE Files
File types: .safetensors, .pt
Examples:
- โ
vae-ft-mse-840000-ema-pruned.safetensors - โ
sdxl_vae.safetensors
Location:
How to use: Load with "VAE Loader" node โ Connect to "VAE Decode"
When you need a VAE:
- โImages look washed out, blurry, or have wrong colors
- โUsing SDXL without built-in VAE
- โWorkflow specifically requires external VAE
ControlNet Models
File types: .safetensors, .pth
Examples:
- โ
control_v11p_sd15_openpose.pth - โ
diffusers_xl_canny_full.safetensors
Location:
How to use: Load with "Load ControlNet Model" node
Note: ControlNet models are also version-specific:
- โSD 1.5 ControlNet โ SD 1.5 checkpoint
- โSDXL ControlNet โ SDXL checkpoint
Embeddings (Textual Inversion)
File types: .pt, .safetensors
Examples:
- โ
bad-hands-5.pt - โ
EasyNegative.safetensors - โ
negative_hand.pt
Location:
How to use: Just place files here. Use in prompts by filename (without extension):
Upscale Models
File types: .pth, .safetensors
Examples:
- โ
RealESRGAN_x4plus.pth - โ
4x-UltraSharp.pth - โ
ESRGAN_4x.pth
Location:
How to use: Load with "Upscale Model Loader" node
IPAdapter Models
File types: .safetensors, .bin
Location:
Typical structure:
#๐ง Organization Tips
Create Subfolders (Recommended)
ComfyUI supports subfolders. Organize like this:
Why?
- โEasier to find files
- โPrevents version mixing
- โBetter performance (fewer files to scan per folder)
#๐จ Common Folder Mistakes
โ Wrong: Putting LoRAs in checkpoints folder
Result: LoRA won't load, or will crash workflow
โ Wrong: Mixing SD 1.5 and SDXL in same folder without subfolders
Better:
โ Wrong: Using OneDrive/Google Drive synced folders
Never put models in:
- โOneDrive
- โGoogle Drive
- โDropbox
- โiCloud Drive
Why?
- โCloud sync locks files
- โCauses loading errors
- โExtremely slow model loading
#๐ฅ How to Download Models
From Hugging Face
- โFind the model page
- โClick "Files and versions"
- โDownload
.safetensorsfiles - โMove to correct ComfyUI folder
Example URLs:
- โSD 1.5:
https://huggingface.co/runwayml/stable-diffusion-v1-5 - โSDXL:
https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0
From Civitai
- โFind the model
- โClick "Download"
- โChoose
.safetensorsformat (preferred over.ckpt) - โMove to correct folder
File size guide:
- โSD 1.5 checkpoint: ~2-4 GB
- โSDXL checkpoint: ~6-7 GB
- โLoRA: 10-200 MB
- โControlNet: 700 MB - 2.5 GB
#๐ Troubleshooting: "Model Not Found"
Model exists but ComfyUI doesn't see it?
Check:
- โ
File is in correct folder
- โCheckpoints in
models/checkpoints/ - โLoRAs in
models/loras/
- โCheckpoints in
- โ
File extension is correct
- โ
.safetensorsor.ckpt(checkpoints) - โ
.safetensorsor.pt(LoRAs, VAE, embeddings)
- โ
- โ
File isn't corrupted
- โCheck file size matches expected
- โRe-download if suspiciously small
- โ
Restart ComfyUI
- โSome folders need restart to refresh
- โPress Ctrl+C in console, restart
- โ
Check file permissions
- โFile isn't "Read Only"
- โFolder isn't locked by cloud sync
#๐ฏ Model Recommendations by Use Case
For Photorealism
Checkpoint:
LoRAs:
For Anime/Illustration
Checkpoint:
LoRAs:
For ControlNet Workflows
Must have:
#๐ Quick Reference Table
| File Type | Extension | Folder | Average Size |
|---|---|---|---|
| SD 1.5 Checkpoint | .safetensors | checkpoints/ | 2-4 GB |
| SDXL Checkpoint | .safetensors | checkpoints/ | 6-7 GB |
| LoRA | .safetensors | loras/ | 10-200 MB |
| VAE | .safetensors | vae/ | 300-800 MB |
| ControlNet | .pth, .safetensors | controlnet/ | 700 MB - 2.5 GB |
| Embedding | .pt, .safetensors | embeddings/ | 5-100 KB |
| Upscaler | .pth | upscale_models/ | 15-65 MB |
#๐พ Managing Disk Space
Models take up massive space
Space-saving tips:
- โ
Delete unused checkpoints
- โOne SD 1.5 + One SDXL is often enough
- โ
Use pruned/EMA versions
- โSmaller file size, same quality
- โLook for "pruned-emaonly" in filename
- โ
Store on external SSD
- โSymlink to external drive:
comfyui-workflow.json - โ
Use
.safetensorsinstead of.ckpt- โOften smaller
- โFaster loading
- โMore secure
#๐ Still Can't Find Your Models?
โ Guide 5: Workflow Errors (Node not found issues)
โ Guide 9: Troubleshooting Assistant
Looking to optimize model loading speed? See Guide 7: Performance Optimization