SideGuy Fixables · Real Human Clarity · Apr 2026
Broken image icons.
Photos not loading.
If images show locally but break on the live site, the image files weren't copied into the deploy folder. The fix is one line in your build script.
Confirm it in 30 seconds
F12 → Network tab → reload. Find the broken image request — it'll show a 404. The URL in that 404 tells you exactly what path the browser expects the file at.
Common causes & fixes
Images folder not copied
Your build script doesn't include the images/ folder in its copy list. Add it and rebuild.
Wrong path in HTML
Paths like ../images/logo.png break on deployed sites. Use root-relative paths: /images/logo.png.
Case-sensitive filename
Servers are case-sensitive. Logo.PNG and logo.png are different files. Match the case exactly.
Images too large
Files over 5MB can fail to load on slow connections. Compress with squoosh.app or imageoptim.
Verify images made it into your build output:
# Check if images folder is in your build: ls -la _site/images/ ls -la _site/public/images/ # Count image files: find _site -name '*.jpg' -o -name '*.png' | wc -l