Regenerate WordPress Thumbnails: 4 Tools & Safe Steps

Changed your WordPress theme and now old featured images look cropped, stretched or blurry? Regenerating thumbnails can create the new image sizes for media you uploaded before the change. Start with the original image and the size settings: regeneration cannot make a small original sharper, and deleting old image files without checking where they are linked can break images elsewhere on your site.

When do you need to regenerate WordPress thumbnails?

WordPress generates derivative image sizes as images are uploaded. A theme, plugin or WooCommerce can register additional dimensions or change the cropping rules. Existing uploads do not automatically gain every newly registered size in every setup, so a new theme can request an image file that was never generated or display the wrong crop. Regeneration creates derivatives from the original source file when that file is available.

Do not regenerate just because an image looks blurry. First open the original attachment and check its pixel dimensions. A 400-pixel-wide original will not become a crisp 1,200-pixel hero through regeneration. Likewise, a stretched thumbnail may be caused by CSS rather than a missing image size. Use your browser’s image URL and displayed dimensions to establish which problem you actually have.

WordPress thumbnail regeneration tools compared

1. Thumbnail Manager: generate only the missing sizes

If your current image files are fine and only newly registered sizes are absent, Thumbnail Manager provides a focused Generate Missing Sizes Only action alongside a force-regenerate option. Its public changelog also documents a review-first process for identifying derivative files that may be eligible for cleanup. These are distinct tasks: generating a missing file is not the same as deleting a file you think is unused.

The trade-off is a relatively small installation base. Test it on one image and verify the resulting sizes in the Media Library and on the front end before running a full library job.

Inspect Thumbnail Manager →

2. reGenerate Thumbnails Advanced: targeted rebuilds

reGenerate Thumbnails Advanced lets you choose which registered sizes to generate and whether to keep already existing ones. The WordPress.org listing documents selection by upload date and featured-image status, as well as progress and interruption controls. That makes it useful after a theme change when you know exactly which size needs rebuilding.

The plugin also offers removal options for unused files and metadata. Leave deletion off for the first run unless you have checked image URLs in older posts, emails, social previews and external sites. A generated filename may still be in use even if the current theme no longer registers that size.

See Advanced’s regeneration controls →

3. Force Regenerate Thumbnails: use when cleanup is intentional

Force Regenerate Thumbnails explicitly deletes older generated sizes and creates new ones. It supports a single attachment, selected Media Library items or a site-wide run. The public changelog documents a resumable process and an additional command-line command.

Its advantage is also its risk: a theme template, newsletter or old post may link directly to a derivative such as photo-300x200.jpg. Removing that file can break the URL even if the original photo.jpg survives. Export a backup of both wp-content/uploads and your database, run one attachment on staging, check its old URLs and only then consider a full run. Do not treat thumbnail cleanup as safe media-library deletion.

Review Force Regenerate’s deletion behavior →

What about the original Regenerate Thumbnails plugin?

The longstanding free Regenerate Thumbnails plugin still has a large installed base and supports regenerating selected or all Media Library images. However, its WordPress.org page currently displays a compatibility warning about the latest three major WordPress releases. Its own changelog says updating references inside post content was disabled because of bugs. If you already use it, check your WordPress version and keep a backup; for a new installation, compare the more recently tested options above. Do not assume that regenerating files rewrites hard-coded old image URLs inside your articles.

How to regenerate thumbnails safely after changing a theme

1. Identify the mismatch. Open a broken image URL, inspect its natural dimensions and compare them with the thumbnail size requested by the new theme. Confirm the original upload still exists.
2. Back up images and the database. An image-file backup alone will not preserve the attachment metadata that WordPress uses to find the derivatives.
3. Regenerate a single representative attachment. Use a landscape and a portrait image if your site uses both. Prefer missing-size-only or keep-existing settings first.
4. Check the front end on desktop and mobile. Review the featured image, image galleries and any posts that link directly to a thumbnail filename. Purge the site or CDN cache if the correct derivative is still not displayed.
5. Run the rest in manageable batches. Keep the browser or CLI job going until it reports completion, inspect failures, and compare disk usage before considering any cleanup.
6. Remove the one-time utility if no longer needed. Keeping multiple image-regeneration plugins active does not create a continuing performance benefit.

WooCommerce product images: try its built-in route first

WooCommerce registers its own product-image sizes. A changed catalogue width or crop can make old products appear inconsistent even when ordinary blog thumbnails are fine. Check your theme’s product image settings first, then look for WooCommerce’s thumbnail regeneration tool under WooCommerce → Status → Tools when available. WooCommerce has also supported background regeneration after certain image-setting changes; let an existing job finish before starting a second one.

If the original product photo is too small or the CSS forces a stretched aspect ratio, regeneration alone will not fix it. Replace undersized source photos or correct the display settings before running another full-library process. For general image file size and format optimization, see WPNeon’s WordPress image optimizer comparison; compression and regeneration solve different problems.

Regenerate thumbnails without a plugin: WP-CLI

Developers with server command-line access can run WP-CLI’s documented media regenerate command. Use it from the correct WordPress installation after backing up.

wp media regenerate --only-missing --yes
wp media regenerate --skip-delete --yes
wp media regenerate 123 --skip-delete

The first command generates sizes that are missing across attachments. The second rebuilds thumbnails without deleting the old files. The third targets a single attachment with ID 123—replace that example ID with your real attachment ID. WP-CLI also supports regenerating one named image size. Do not use deletion flags until you understand which derivative URLs are referenced elsewhere.

Why do thumbnails still look wrong after regeneration?

• Original is too small: upload a higher-resolution source image.
• Wrong aspect ratio: inspect the theme’s image sizes and hard-crop settings; regenerate only after fixing the requested dimensions.
• Old image URL remains in the page: inspect the image’s actual src and srcset. A regeneration plugin might create new files without updating an old hard-coded URL.
• Cache still serves the previous file: clear the page cache and CDN image cache after verifying the files exist.
• Job timed out: regenerate fewer attachments per batch or use WP-CLI; verify the final success and error counts instead of assuming every image finished.

Frequently asked questions

Does WordPress regenerate thumbnails automatically when I change themes?

Not in every setup. WordPress generates registered sizes when an image is uploaded, while an already-uploaded image may need additional derivatives after a theme registers new sizes. WooCommerce has separate background regeneration behavior for certain product-image changes.

Can regenerating thumbnails delete my original image?

Normal thumbnail regeneration targets derivatives, not the original upload, but cleanup and force-regeneration options can delete older generated files. Back up the upload directory and database and test first; never infer that an old derivative is unused solely because a theme no longer registers its size.

Will regeneration fix blurry product images?

Only if an appropriately sized original exists and the problem is an absent or mismatched derivative. It cannot restore detail missing from a low-resolution source or repair stretching caused by CSS.

Which WordPress thumbnail plugin should I install?

For missing sizes, start with Thumbnail Manager or WP-CLI’s --only-missing mode. For selecting particular sizes and keeping existing files, check reGenerate Thumbnails Advanced. Force Regenerate is for deliberate cleanup after backups and URL checks.

Next step: start with the selective regeneration settings, or use WP-CLI if you have shell access. Fix one image and verify the live page before changing your whole library.