Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Troubleshooting

Why Are Your WordPress Images Blurry? Causes and Fixes

Why Are Your WordPress Images Blurry? Causes and Fixes

Short answer

WordPress images usually look blurry because a small image size is stretched to fill a wider space, or because compression is too aggressive. Fix it by uploading larger originals, choosing a bigger size in the block or theme settings, easing compression and regenerating thumbnails.

Key takeaways

  • Blur usually means a small image is being stretched by the browser.
  • Check the Image block Resolution setting and your theme's image sizes first.
  • Aggressive compression can soften photos and text-heavy images.
  • Regenerate thumbnails after switching themes.
  • Clear plugin and CDN caches before testing a fix.

Why are my WordPress images blurry?

WordPress images usually look blurry because the browser is stretching a file that is smaller than the space it fills, or because the image was compressed too hard on upload.

Most of the time nothing is broken. WordPress, your theme or a plugin has simply picked an image size that is too small for the layout, the screen, or both.

High-density screens make this worse, as the web.dev guide to serving responsive images explains. A phone or laptop with a sharp display needs roughly twice as many pixels as the layout width, so an image that looks fine on an old monitor can look soft on a new one.

The good news is that every common cause has a clear fix. The sections below walk through them in the order most people find them.

MDN's reference for the img element explains the srcset and sizes attributes that WordPress adds to pick the right image file for each screen.

How does WordPress create different image sizes?

When you upload an image, WordPress saves the original and creates several smaller copies, then your theme decides which copy to show in each place.

By default WordPress makes a thumbnail, a medium, a medium-large and a large version. Themes and plugins often register extra sizes with the add_image_size() function.

WordPress also adds a srcset attribute to most images. This gives the browser a list of available sizes so it can choose a suitable one for the screen, which the MDN guide to responsive images explains in plain terms.

Trouble starts when the list does not include a size big enough. The browser then takes the largest one on offer and stretches it, which is where the blur comes from.

CauseWhat you seeTypical fix
Image smaller than its containerSoft image everywhereUpload a larger original
Theme uses a small registered sizeBlurry featured or archive imagesPick a larger size or change theme settings
Heavy compressionBlocky edges, banding, smudged textLower compression or raise quality
Missing or old thumbnailsWrong crop or tiny image stretchedRegenerate thumbnails
Page builder or slider scalingBlur only in one widgetChange the widget's image size option
CSS stretching the imageBlur after a theme changeFix width and height rules

Is the uploaded image too small?

If the original file is narrower than the area it fills, no setting can make it sharp, because the missing pixels were never there.

Open the image in the Media Library and check its dimensions in the attachment details panel. Then compare that number to the width of the area on your page.

A full-width hero on a wide screen may need an image around 2,000 pixels wide or more. A content-width image in a blog post often needs about twice the column width to stay crisp on high-density displays.

If the original is too small, replace it with a larger version. Our guide on how to properly size images in WordPress covers sensible widths for common layouts.

Avoid upscaling a small file in an editor before uploading. That only adds blur of its own and makes the file heavier.

Is your theme loading a small image size?

Many blurry images come from a theme or block that requests the thumbnail or medium size for an area that is much wider than that size.

In the block editor, select the Image block and look at the Resolution option in the block settings sidebar. Switching from Medium to Large or Full Size often fixes a soft image straight away.

Featured images, archive grids and sliders are controlled by the theme instead. Check the theme's customizer or settings panel for an image size or layout option, and read its documentation if nothing is obvious.

If you need a size the theme does not offer, a developer can register one with add_image_size() and use it in the template. The WordPress developer reference for image sizes lists the options for cropping and dimensions.

Setting featured images correctly matters here too. The steps in how to set a featured image in a WordPress post help you check which image the theme is actually pulling.

Is compression making your images look soft?

Yes, compression is a common cause, because WordPress and most optimization plugins reduce JPEG quality to save file size, and aggressive settings show up as blur and blocky edges.

WordPress applies its own quality setting when it creates resized copies. Developers can change this with the wp_editor_set_quality filter, which sets the quality used by the image editor.

Optimization plugins add a second layer. Many offer modes such as lossless, glossy or lossy, and the most aggressive mode can visibly soften photos, screenshots and images with text.

Try a gentler compression level and re-optimize one affected image. If it looks better, apply the same setting to the rest of the library.

Screenshots and images with small text usually look better as PNG or a high-quality WebP. Our page on how to serve images in next-gen formats explains when each format makes sense.

Did WordPress scale down a very large upload?

WordPress scales down very large images on upload, but the scaled copy is still large, so this alone rarely causes visible blur on normal layouts.

Since WordPress 5.3, images wider or taller than a set threshold are scaled down and saved with -scaled in the file name. The default limit is 2,560 pixels, and the big_image_size_threshold filter lets developers change or disable it.

WordPress keeps the original file on the server. It just uses the scaled version as the main image for the site.

This only matters if you show images wider than that limit, such as very large full-screen photography. In that case, a developer can raise the threshold with the filter.

Are thumbnails missing or out of date?

Old or missing thumbnails can cause blur, because WordPress may fall back to a smaller size or the theme may stretch a size that no longer matches its layout.

This often happens after switching themes. The new theme registers different sizes, but images uploaded earlier were only resized to the old theme's dimensions.

Regenerating thumbnails creates the missing sizes for existing images. The free Regenerate Thumbnails plugin is a common way to do this, and WP-CLI users can run wp media regenerate.

If new uploads are not producing sizes at all, the server's image library may be the issue. Our guide to fixing thumbnails not generating covers that problem.

Could a page builder, slider or lazy loading be the cause?

Yes, page builders and sliders often have their own image size option, and some lazy loading setups show a low-quality placeholder that never gets replaced.

In builders such as Elementor or WPBakery, check the image widget for a size or resolution setting. Many default to a medium size that looks soft in wide columns.

Sliders and galleries may crop and resize images with their own settings. Look for options like image quality, crop mode or thumbnail size in the plugin's panel.

Some lazy loading tools first load a blurred placeholder and swap in the real image when it scrolls into view. If a script conflict stops the swap, the blurry placeholder stays. Our guide on how to lazy load images in WordPress explains how these setups work.

Is CSS stretching the image?

Sometimes the image file is fine but CSS forces it wider or taller than its real size, which makes the browser scale it up.

Right-click the blurry image and choose Inspect in your browser. Compare the rendered size shown in the developer tools with the natural size of the file.

If the rendered size is much larger, look for rules such as width: 100% on a small image, or a fixed height with object-fit that crops and enlarges it.

The quickest fix is usually to load a larger image size. If the CSS rule comes from a recent change, adjust it in the theme's custom CSS or ask the theme's support team.

How do you fix blurry images step by step?

Work from the cheapest check to the most involved one, and test a single image before changing anything site-wide.

  1. Check the original file's dimensions in the Media Library.
  2. Inspect the image in the browser to see which file and size are loading.
  3. In the Image block, set Resolution to Large or Full Size.
  4. Review your theme's image size and layout settings.
  5. Ease off compression in your optimization plugin.
  6. Regenerate thumbnails after any theme change.
  7. Check builder, slider and lazy loading settings.
  8. Clear your caching plugin and CDN cache, then test again.

Clearing caches matters because an old blurry version can stay in place after you fix it. If you use a CDN with image resizing, check its quality setting as well.

For shops, product images have their own size settings. Our separate guide on fixing blurry WooCommerce product images covers those.

How can you stop images going blurry in future?

Upload images that are large enough for their biggest use, keep compression moderate, and recheck image sizes whenever you change themes.

A simple habit is to export photos at a fixed width that suits your widest layout. That keeps files consistent and avoids both tiny and oversized uploads.

Test new templates on a high-density phone screen, not just a desktop monitor. Blur shows up there first.

Our broader guide on how to optimize images for WordPress covers file sizes, formats and speed together, so you can keep images sharp without slowing the site.

Frequently asked questions

Does WordPress reduce image quality on upload?

WordPress creates resized copies of each upload and applies a quality setting to them, so those copies are slightly compressed. The original file is kept on the server. Optimization plugins may add further compression, which is often the bigger cause of visible quality loss.

What size should images be for WordPress?

It depends on where they appear. A good rule is to make the image about twice as wide as the space it fills, so it stays sharp on high-density screens. Full-width banners need much wider files than images inside a blog post column.

Why are my images sharp in the editor but blurry on the live site?

The editor and the front end can load different image sizes. Your theme, a page builder, a lazy loading tool or a CDN may serve a smaller or more compressed version on the live page. Inspect the image in the browser to see which file actually loads.

Will regenerating thumbnails fix blurry images?

It helps when the blur comes from missing or outdated image sizes, which is common after a theme change. It will not help if the original upload is too small or if compression settings are too aggressive, so check those causes as well.

Is WebP blurrier than JPEG?

Not by nature. WebP can look just as sharp as JPEG at a smaller file size. Blur appears when the quality setting used for conversion is too low, so raise the quality in your conversion plugin if WebP images look soft.

Sources

  1. add_image_size() WordPress Developer Resources
  2. big_image_size_threshold WordPress Developer Resources
  3. wp_editor_set_quality WordPress Developer Resources
  4. Regenerate Thumbnails WordPress.org Plugins

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.