Skip to content
Tools

Disable -scaled Images

Stop WordPress silently shrinking your big uploads

Runs in your browser. Nothing is uploaded.

Your image

What WordPress will do

What do you want instead?
functions.php (child theme) or a small plugin

This only affects images uploaded AFTER the filter is active. Images already on your site keep their -scaled copies until you re-upload or regenerate them.

About the Disable -scaled Images

Since 5.3, WordPress downscales any image over 2560px and serves a "-scaled" copy instead of your original. It is the single most common reason an image looks soft after upload. This generates the filter that turns it off.

FAQ

Questions

Why does my image look blurry after uploading to WordPress?

Because since WordPress 5.3, any image whose longest edge exceeds 2560px is downscaled, and WordPress serves that '-scaled' copy instead of your original. Your original is still on disk — it is simply never used. This is the most common cause of soft images and almost nobody knows it exists.

Should I disable -scaled images entirely?

Only deliberately. Turning it off means WordPress serves your full-resolution original — which is right for photography and print-adjacent sites, and wrong for a normal blog, where shipping a 6000px hero to a phone is a real performance cost. Raising the threshold is often the better middle ground.

Does this fix images I already uploaded?

No. The filter only affects images uploaded after it is active. Existing images keep their -scaled copies until you re-upload them or regenerate thumbnails.