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.
Hardware Partner
Running these workflows? ComputeAtlas.ai helps you find the right GPU
Optimization is only half the battle. Get precise VRAM benchmarks and hardware recommendations tailored for ComfyUI.
Check GPU Prices โ#๐ 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
Hardware Partner
Running these workflows? ComputeAtlas.ai helps you find the right GPU
Optimization is only half the battle. Get precise VRAM benchmarks and hardware recommendations tailored for ComfyUI.
Check GPU Prices โ