The short answer
A blurry image is a small file stretched larger than it was saved, or a file the platform compressed too hard. A broken image, the small placeholder icon, means the file is missing: it was deleted, moved or renamed, or the link points to the wrong place. They are two problems with two fixes. Pick what you see in the finder below.
What to know
- Blurry equals a low-resolution image stretched too big, or over-compression. The fix is a larger, cleaner source file.
- A broken-image icon means the file is missing or the address is wrong. A sharper file will not fix it.
- High-density phone and laptop screens make an image look soft even if it looked fine on an older monitor.
- Uploading images at the size they'll display avoids both blurriness and slow loading.
- Broken images after a site move trace back to a changed folder path or a media library that did not come across.
Website images look blurry when the file is smaller than the space it fills, and they show as broken when the file is missing from the address the page points to. Pick what you see below and you get the cause and the fix.
Find your cause
What is wrong with your images?
Answer two or three questions about what you see. Your answers stay in your browser.
What do you see where the image should be?
The table shows each cause and how to recognize it. The sections after it walk through the fix.
| Cause | How common | The tell |
|---|---|---|
| Low-resolution image stretched too large | Very common | Blurry or pixelated, worse the bigger it displays. |
| Over-compression by the platform or a plugin | Common | Blocky, muddy detail even though the file is a decent size. |
| High-density (retina) screen exposing a small image | Common | Looked fine on an old monitor, soft on a modern phone or laptop. |
| File moved, deleted, or renamed | Common | Broken-image icon. The image is not at the address given. |
| Wrong or broken image URL after a site move | Common | Broken icons appear after a migration or a domain change. |
Fixing blurry images
Blurriness is a resolution problem. The image is smaller than the space it fills, so the browser stretches it and softens every detail. A logo saved at 200 pixels wide looks crisp at that size and soft when it fills a 600-pixel header. For logos, see why a logo looks blurry.
The fix is to upload a source file at least as large as the space it displays in. Modern phones and laptops have high-density screens that pack in extra pixels, so a good rule is to use an image roughly twice the display dimensions. For a 400-pixel spot, upload an 800-pixel version. It stays sharp and the file stays small.
Check for over-compression too. Some platforms and optimization plugins shrink images so hard that the quality drops. If your originals are sharp and they look blocky once uploaded, lower the compression one step. File size and quality pull against each other, and the same trade-off affects speed, which our guide on a site that is slow on mobile covers.
Fixing broken images
A broken image is a different problem. The file is not loading at all. The browser asked for it at a specific address and found nothing, so it shows a placeholder. Something happened to the file or to the link that points to it.
The usual causes are a file deleted from the media library, a renamed file, a moved folder, or a link that points to the wrong place. Broken images that appear right after a site move or a domain change come from addresses that still point at the old location, or a media library that did not come across. Our guide to moving a website to a new host covers the full move.
To fix one, check the image's link and confirm the file exists at that address. Re-uploading the image and re-inserting it clears a one-off case. When a whole batch breaks after a move, run a search-and-replace on the old paths. It is faster than fixing each image by hand. For more causes, see images not loading on my website.
Upload images the right size in the first place
Size each image for the spot it fills before you upload it, and both problems go away. A file that is too small blurs. A file that is far too large loads slowly, and a platform that compresses uploads will soften it. The table gives each platform's own numbers, and what size images should be for a website gives sizes for each spot on a page.
| Platform | Upload size | Limit | Quality setting |
|---|---|---|---|
| WordPress | About twice the display width | Set by your host | In your image plugin |
| Squarespace | About 2500 pixels wide, 500 KB or less | 20 MB | None |
| Wix | At least 2560 by 1440 pixels | Compress files over 25 MB first | Pro Gallery only, up to 90 |
| Shopify | 2048 by 2048 pixels for square product photos | 5000 by 5000 pixels, 20 MB | None |
Each number comes from the platform's own help pages, listed under Sources.
How to fix blurry images in WordPress, Squarespace, Wix and Shopify
The cause is the same on every platform. The setting you change differs, and two platforms have no setting at all. Here is where to look on each.
WordPress
WordPress makes several copies of every image you upload. The three built-in sizes live under Settings > Media: Thumbnail (150 by 150 pixels, cropped), Medium (300 by 300) and Large (1024 by 1024). Most themes register a few more on top of those. Changing a number in Settings > Media only affects images you upload afterward. Everything already in the library keeps the copies WordPress made the day it was uploaded, which is why a theme switch can make a whole site go soft at once. The fix is the Regenerate Thumbnails plugin: install it, then run it from Tools > Regenerate Thumbnails to rebuild every size across the media library. Regenerating a large library takes a while, so start it when the site is quiet.
Squarespace
Squarespace has no quality slider. It resizes every upload into seven widths, 100, 300, 500, 750, 1000, 1500 and 2500 pixels, and then serves the smallest one that still fills the space on screen. That is why a photo goes blurry here. Upload a 900-pixel file into a full-width banner and there is no 1500 or 2500 version to reach for, so a 750-wide copy gets stretched. Squarespace's own guidance is to upload around 2500 pixels wide and keep the file at 500 KB or less (the hard limit is 20 MB). The fix is to replace the image with a larger source file.
Wix
Wix converts uploads to AVIF and asks for high-resolution originals, a minimum of 2560 by 1440 pixels, with anything over 25 MB compressed before you upload it. Wix has a quality control inside the Pro Gallery only: click the gallery, click Settings, open the Advanced tab and scroll to Advanced Image Settings. There's an Image Quality slider and a sharpening toggle. Wix advises against pushing quality past 90, because the page loads slower and the image looks the same. For images outside a gallery, upload a better source file, as on Squarespace.
Shopify
Shopify's documentation recommends 2048 by 2048 pixels for square product images, with a ceiling of 5000 by 5000 pixels (25 megapixels) and 20 MB per file. On a Shopify store, ratio causes as much blurriness as resolution does. Theme templates crop product images to one aspect ratio, so a photo shot in a different shape gets scaled to fit and softens. Shoot and export every product image at one consistent ratio and the whole grid stays sharp.
- 01Measure the space the image will fill. Right-click that spot in your browser, choose Inspect, and read the rendered width in pixels.
- 02Double it. Phone and laptop screens pack in extra pixels, so an image shown at 600 pixels wants a 1200-pixel file.
- 03Then check the platform's own number. Roughly 2500 pixels wide on Squarespace, 2048 square on Shopify, at least 2560 by 1440 on Wix. Use the platform's number when it is larger than yours.
- 04Pick the right format. JPEG for photographs, PNG when you need transparency on a flat graphic, SVG for logos and icons so they stay crisp at any size.
- 05Look at the file size before you upload. Around 500 KB is a sane target for a full-width photo. A 6 MB camera original is too large.
- 06Upload one and check it on a phone. If that single image holds up on a real handset, batch the rest. If it does not, fix that one before you do the rest.
Get help with your website images
On our website maintenance plans, you email us the photos and our team sizes, compresses and places them. Most changes go live within 48 to 72 hours, and a site that is down or broken gets handled right away.
We are in Mill Creek, Washington, north of Seattle, and we work with businesses across the Puget Sound and around the country. If you want your images fixed for you, get in touch.
Get help from Venbit
More website guides
Every question in this series, from Fix website problems.
Symptoms & emergencies17
- What Size Should Images Be for a Website?
- Why Is My Logo Blurry on My Website? How to Fix It
- Images Not Loading on My Website? 9 Causes and Fixes
- Why Is My Website Down Right Now? How to Fix It
- Why Does My Website Say "Account Suspended"?
- Why Is My Contact Form Not Sending Emails?
- There Has Been a Critical Error on This Website: How to Fix It
- Why Is My Website Showing "Not Secure" in Chrome?
- Squarespace Site Not Showing Up on Google? How to Fix It
- Why Did Google Remove My Website From Search Results?
- Why Did My Website Traffic Suddenly Drop? Top Causes
- Why Is My Website Slow on Mobile but Fast on Desktop?
- Why Does My Website Look Broken on My Phone?
- Why Do My Website Images Look Blurry or Broken? (you are here)
- How to Tell If Your Website Has Been Hacked
- "This Site May Be Hacked": How to Remove Google's Warning
- How to Fix the "Deceptive Site Ahead" Warning
What happens if...11
- Hosting Company Shut Down? What to Do in the First 24 Hours
- How to Get Your Website Files From Your Hosting Company
- Hosting Expired and Your Website Is Down? What You Can Recover
- How to Recover a Deleted Website
- How to Move a Website to a New Host Without Downtime
- Is My Web Host Going Out of Business? Signs to Check
- What Happens If My SSL Certificate Expires?
- What Happens If My Domain Name Expires?
- What Happens If Your Web Host Goes Out of Business?
- What Happens If You Stop Paying Your Web Developer?
- Why Are My Business Emails Going to Spam?
Plans & hiring1
Ownership & switching11
- How to Find Out Who Built Your Website
- How to Find Out Who Owns a Domain Name
- Locked Out of Your Own Website? How to Get Access Back
- How to Transfer a Website to a New Developer
- Website Ownership Checklist for a Small Business
- What Is My Website Built With? How to Check in Seconds
- How to Find Out Who Hosts and Manages Your Website
- What to Do When Your Web Developer Disappears
- How to Switch Web Hosting Without Losing Your Email
- Who Is My Email Provider? How to Find Out in Two Minutes
- How to Back Up a WordPress Website Yourself
Platform-specific3
Seattle & local1
The Venbit Team
Web design & SEO, Mill Creek, WA
Venbit is a web design, SEO, and digital marketing studio in Mill Creek, Washington. Since 2011 we've designed, built, and ranked small-business websites for clients across the Puget Sound and around the country, so the numbers and advice here come from real projects, not a content mill.
