Why Do My Website Images Look Blurry or Broken?

The Venbit TeamUpdated November 9, 20266 min read

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.

CauseHow commonThe tell
Low-resolution image stretched too largeVery commonBlurry or pixelated, worse the bigger it displays.
Over-compression by the platform or a pluginCommonBlocky, muddy detail even though the file is a decent size.
High-density (retina) screen exposing a small imageCommonLooked fine on an old monitor, soft on a modern phone or laptop.
File moved, deleted, or renamedCommonBroken-image icon. The image is not at the address given.
Wrong or broken image URL after a site moveCommonBroken icons appear after a migration or a domain change.
Blurry and broken images: each cause and how to spot it

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.

PlatformUpload sizeLimitQuality setting
WordPressAbout twice the display widthSet by your hostIn your image plugin
SquarespaceAbout 2500 pixels wide, 500 KB or less20 MBNone
WixAt least 2560 by 1440 pixelsCompress files over 25 MB firstPro Gallery only, up to 90
Shopify2048 by 2048 pixels for square product photos5000 by 5000 pixels, 20 MBNone
Image upload sizes each platform recommends

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.

  1. 01Measure the space the image will fill. Right-click that spot in your browser, choose Inspect, and read the rendered width in pixels.
  2. 02Double it. Phone and laptop screens pack in extra pixels, so an image shown at 600 pixels wants a 1200-pixel file.
  3. 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.
  4. 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.
  5. 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.
  6. 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.

More website guides

Every question in this series, from Fix website problems.

Symptoms & emergencies17
What happens if...11
Plans & hiring1
Ownership & switching11
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.

Questions & Answers

  • The uploaded file is smaller than the space it displays in, so the browser stretches it and softens the detail. Upload a version at least as large as the display size, ideally about twice as large to stay sharp on high-density screens. For logos specifically, a vector file like SVG stays crisp at any size.

  • It means the browser couldn't find the image file at the address it was told to look. The file was likely deleted, renamed, or moved, or the link points to the wrong place. Check that the file still exists at the linked location and re-upload or fix the path if it doesn't.

  • Migrations leave image links pointing at the old location, or the media library doesn't fully transfer. The pages reference addresses that no longer resolve, so the images break. The fix is a search-and-replace to update the old paths to the new ones, plus confirming the media files came across in the move.

  • Match the image to where it'll display, then roughly double it for high-density screens. If a photo shows at 500 pixels wide, upload it around 1,000 pixels. That keeps it sharp and the file small. Uploading much bigger than needed slows the page and can trigger aggressive auto-compression that hurts quality.

Keep reading

Let’s grow your business

Tell us about your business. We would love to hear from you. Or call us at (425) 314-1415.

Join the local businesses that grow with us

  • Pawn Fathers
  • Protectee
  • Pinnacle Energy Services
  • See Clearwater Beach
  • Q Blinds
  • Domaine des Florines
  • Track & Field AI
  • Edgewater Commercial Park
  • Colour Play Salon
  • Houston Hurricane & Security