What is Regenerate Thumbnails plugin?
Regenerate Thumbnails is a free WordPress utility plugin that solves one of the most common WordPress maintenance tasks: regenerating all image thumbnail sizes after changing a theme or modifying thumbnail dimensions. WordPress generates multiple thumbnail sizes for each uploaded image based on the sizes defined by the active theme and any installed plugins. When you switch themes or change image size settings, previously uploaded images still have thumbnails at the old dimensions — Regenerate Thumbnails recreates all thumbnails for all existing images to match the current size configuration.
The plugin processes images in the browser via AJAX, showing a progress bar as it works through the media library. It can regenerate all images at once or selected images individually. A “Delete unused thumbnail sizes” feature removes old thumbnail files that no longer correspond to any registered size — reclaiming disk space that accumulates over time from size changes. The plugin is completely free with no premium tier and is the standard solution for the thumbnail regeneration task.
Common use cases: switching WordPress themes (each theme defines its own thumbnail sizes), updating a plugin that registers new image sizes (WooCommerce defines product thumbnail sizes), or manually changing image dimensions in Settings → Media. After any of these changes, running Regenerate Thumbnails ensures all images in the media library have correctly sized thumbnails.
Need Help With Regenerate Thumbnails Setup, Troubleshooting, or Customization?
Need help with Regenerate Thumbnails? Whether you are dealing with errors, broken functionality, styling problems, plugin conflicts, or advanced customization, we can help you fix the issue and get the plugin working properly on your WordPress site.
Get Regenerate Thumbnails Expert HelpKey Features
- Bulk thumbnail regeneration for all images in the media library
- Individual image regeneration from the media library
- Progress bar with real-time status during bulk regeneration
- Delete unused thumbnail sizes to reclaim disk space
- Skip existing thumbnail regeneration (only create missing sizes)
Pros & Cons
Pros
- The standard solution for WordPress thumbnail regeneration — widely used and well-maintained
- WP-CLI support allows faster bulk processing on large libraries via command line
- Delete unused sizes helps reclaim disk space that accumulates from multiple theme/size changes
Cons
- Browser-based processing can time out on very large media libraries (thousands of images) — WP-CLI is more reliable for large regenerations
- Regenerating thumbnails re-creates files on disk but does not automatically update CDN-cached versions
Free vs Premium
Completely free. No paid version.
Common Problems & Fixes
Regenerate Thumbnails is timing out midway through processing a large media library. How do I complete regeneration without timeout errors?
For large libraries, use WP-CLI instead of the browser-based interface: run “wp media regenerate –yes” from the server command line. WP-CLI processes images much faster and does not have browser timeout limitations. If WP-CLI is not available, increase the PHP max_execution_time setting via your hosting control panel or php.ini, and reduce the number of images regenerated per batch in the plugin settings if available.
After running Regenerate Thumbnails, images still appear at the old dimensions on the frontend. How do I fix the display?
If thumbnails were regenerated but display sizes are unchanged: (1) clear all page and CDN caches — browsers and caches may serve the old thumbnail files; (2) verify the new size dimensions are correctly registered — check Settings → Media for the configured sizes; (3) if using a CDN (Cloudflare, BunnyCDN), purge the CDN cache for image files; (4) check if a caching plugin is storing image URLs without the updated query string — some performance plugins cache image URLs and need a cache flush after thumbnail regeneration.
Regenerate Thumbnails reports some images as failed during regeneration. How do I handle failed images?
Failed images typically have one of these issues: (1) the original image file no longer exists on disk — it was deleted from the server directly without removing from the media library; (2) the image file is corrupted — download it from the media library and verify it opens correctly; (3) insufficient PHP memory for large image files — increase PHP memory_limit (128MB-256MB recommended for image processing); (4) image dimensions too small for requested thumbnail sizes — an image smaller than the thumbnail size cannot be resized larger.
Customization & Developer Notes
How do I use WP-CLI to regenerate thumbnails for only specific image sizes?
WP-CLI’s media regenerate command supports specifying image sizes: wp media regenerate –image-size=thumbnail –yes regenerates only the “thumbnail” size. Replace “thumbnail” with any registered size name (medium, large, medium_large, or any custom size name registered by your theme or plugins). Use wp media image-size to list all registered sizes and their names. Targeting specific sizes is much faster when only one or two sizes changed and full regeneration is not necessary.
How do I delete old thumbnail files that are no longer needed after changing image sizes?
In Regenerate Thumbnails → Settings, enable “Delete old thumbnail files that are no longer needed” before running regeneration. With this option enabled, the plugin removes thumbnail files on disk for sizes that are no longer registered (sizes from old themes or removed plugins). Alternatively, the “Regenerate Thumbnails Advanced” plugin provides more granular control over which thumbnail sizes to delete. Warning: Deleted thumbnails cannot be recovered — ensure you have a site backup before running aggressive cleanup.
Frequently Asked Questions
When do I need to regenerate thumbnails?
Regenerate thumbnails after: (1) switching WordPress themes — new theme registers different thumbnail sizes; (2) changing image dimensions in Settings → Media; (3) installing or removing plugins that register custom image sizes (WooCommerce, portfolio plugins); (4) manually modifying the add_image_size() calls in your theme’s functions.php. You do not need to regenerate for newly uploaded images — WordPress generates correct thumbnails automatically on upload based on current size settings.
Does regenerating thumbnails affect image quality?
Thumbnail regeneration always creates thumbnails from the original full-size image file stored in your WordPress uploads directory. As long as the original image is of sufficient quality, regenerated thumbnails will be at the same quality as thumbnails generated on original upload. If the original image was low resolution, regeneration cannot improve it. WordPress uses its configured JPEG quality setting (default 82%) for thumbnail generation.
Can Regenerate Thumbnails break after updates?
Yes, that can happen, especially on older sites with many plugins. This usually happens when the plugin, theme, and add-ons are updated out of sequence. In most cases, testing on staging catches the issue before it reaches the live site. From experience, backups and changelog reviews save a lot of cleanup time.
What should I check before installing Regenerate Thumbnails?
Start by checking whether another plugin already does the same job. In most cases, overlap is what creates avoidable conflicts and performance issues. A common issue is installing a plugin because it looks convenient without checking the stack first. From experience, a short compatibility review avoids most of the pain later.