Thumbnail Manager

Thumbnail Manager helps you control WordPress thumbnail generation, regenerate image sizes, and clean unused thumbnail files from the Media Library.

Use it after changing themes, installing WooCommerce, disabling custom image sizes, or cleaning up years of generated media files. The plugin focuses on predictable thumbnail management: choose which image sizes should stay enabled, rebuild the thumbnails you need, preview cleanup results, then delete only reviewed generated files.

Cleanup is metadata-aware and safety-focused. Thumbnail Manager validates uploads paths, protects original full-size images, runs prune/delete actions in batches, and updates attachment metadata after deleted thumbnail sizes are removed.

Key Features

• Regenerate WordPress thumbnails for existing image attachments
• Generate only missing thumbnails or force-regenerate all selected images
• Disable unwanted registered image sizes for future uploads
• Prune unused thumbnails while keeping selected sizes
• Run Dry-run previews before deleting generated thumbnail files
• Detect legacy thumbnail sizes stored in attachment metadata
• Report disk-only orphan matches without deleting unmapped files by default
• Scan recommendations based on protected sizes, WooCommerce-related sizes, generated metadata, and common content references
• Process large Media Libraries with cursor-based AJAX queues and folder scoping
• Manage everything from Tools > Thumbnail Manager

Common Use Cases

• Clean WordPress thumbnail bloat after theme or page builder changes
• Regenerate thumbnails after changing Media Settings or custom image sizes
• Reduce WooCommerce image storage by reviewing generated product thumbnails
• Disable image sizes that should no longer be created for new uploads
• Rebuild missing thumbnails after migration, restore, or failed image processing
• Audit legacy thumbnail sizes left behind by old themes and plugins

Safety First

Thumbnail Manager is designed for controlled cleanup, not blind filesystem deletion.

• Original full-size images are not deleted
• Delete mode requires a fresh delete token and a completed scan
• Dry-run mode never deletes files
• Cleanup targets files from attachment metadata
• Disk-only orphan matches are reported, not deleted by default
• Paths are validated under the WordPress uploads directory before deletion
• Attachment metadata is updated after generated thumbnail sizes are removed

What It Does Not Do

• It does not compress or optimize image quality
• It does not replace image optimization or CDN plugins
• It does not automatically delete media without confirmation
• It does not delete original uploaded images
• It does not unregister image sizes from themes or plugins

Usage

Recommended Workflow

1. Open Tools > Thumbnail Manager.
2. Scan Recommendations to review likely keep/remove sizes.
3. Apply recommended sizes if they match your site.
4. Open Thumbnail Sizes and save the sizes you want generated for future uploads.
5. Run Regenerate to rebuild missing or selected thumbnails.
6. Open Prune Files and run Dry-run before any deletion.
7. Review matched files, then switch to Delete only when the preview is correct.

Regenerate Thumbnails

Use Regenerate when you need to rebuild WordPress image sizes for existing attachments. You can process all media, the current year, a specific uploads folder, or specific attachment IDs.

Prune Files

Use Prune Files to clean generated thumbnails for sizes you no longer want to keep. Always run Dry-run first. If orphan discovery is enabled, metadata-backed legacy sizes can be included, while unmapped disk-only matches are reported for review.

Thumbnail Sizes

Use Thumbnail Sizes to control which registered image sizes WordPress should generate for future uploads. This setting does not remove existing files until you run Prune Files.

Technical Notes

• Uses intermediate_image_sizes_advanced to control future thumbnail generation
• Uses cursor-based AJAX queues for regenerate and prune scans
• Uses attachment metadata for prune candidates
• Validates filesystem paths under the uploads directory before deletion
• Updates attachment metadata after generated thumbnail files are removed
• Requires the manage_options capability
• Works per site on multisite installations

Privacy

Thumbnail Manager does not collect, store, or transmit personal data. All thumbnail scans, regeneration actions, and cleanup actions run locally on your WordPress site.