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 ā