About this plugin
TinySharp Thumbnail Audit & Repair helps WordPress site owners and developers inspect and rebuild image sub-sizes without treating the Media Library like a black box.
The plugin focuses on a safe workflow:
- Scan the Media Library without changing files.
- See missing metadata, physically missing thumbnail files, and image sizes whose stored dimensions no longer match the current WordPress configuration.
- Repair detected issues, regenerate missing thumbnails only, rebuild all current sizes, or choose specific sizes.
- Review exactly how many images changed, how many thumbnail files were generated, which images were already complete, and which items need attention.
Free features
- Non-destructive Media Library audit.
- Detect missing thumbnail metadata.
- Detect thumbnail metadata whose physical file is missing.
- Detect current image-size names whose stored dimensions no longer match what WordPress would generate today.
- Separate historical/unregistered image-size metadata from repairable current-size problems.
- Exclude known WordPress Site Icon auxiliary sizes from misleading historical-size warnings.
- Show issue examples so you can see which image attachments need attention.
- Regenerate detected missing and outdated thumbnails with the recommended Repair mode.
- Regenerate missing thumbnails only.
- Regenerate all currently registered WordPress image sizes.
- Regenerate selected image sizes.
- Regenerate a Media Library selection from list view.
- One-image-per-request processing to avoid one giant PHP request.
- Pause and resume a browser-driven job.
- Resume a stored job after leaving the page.
- Safely stop a job.
- Skip a single image if a request-level problem repeatedly blocks progress.
- Continue the queue when one attachment reports a normal processing error.
- Track checked images, changed attachments, generated thumbnails, already-complete images, partial results, and failures separately.
- Keep a local regeneration history.
- Configurable non-destructive large source-image audit threshold.
- No telemetry and no external image processing service.
What Repair mode does
Repair mode checks each image against image sizes currently registered by WordPress, the active theme, and plugins. It rebuilds only:
- sizes missing from attachment metadata,
- sizes whose metadata exists but the referenced thumbnail file is missing,
- sizes whose stored dimensions no longer match the dimensions WordPress would generate with the current configuration.
Images that already satisfy the selected mode are reported as “Already complete” rather than being presented as failures or unexplained skips.
Historical / unregistered size records
Changing a theme, plugin, or Media setting can leave old image-size names in attachment metadata. TinySharp reports these separately because an unregistered size is not automatically safe to delete: older content can still reference its file URL.
This release does not delete historical thumbnail files. The audit reports them for review only.
Resumable processing
TinySharp Thumbnail Audit & Repair processes one image attachment per request and stores job progress temporarily. If you leave the page, return to the Regenerate screen and resume the job. If a request repeatedly fails on one image, you can skip that current image and continue the rest of the queue.
Important safety behavior
- Original uploads are never deleted by this plugin.
- The audit does not modify files or attachment metadata.
- Regeneration updates WordPress attachment metadata for successfully rebuilt current sizes.
- When a current image size changed dimensions, an older generated file can remain on disk. This version intentionally does not delete it automatically.
- “All current sizes” and “Selected sizes” are explicit rebuild modes and can regenerate files even when current metadata already exists.
Privacy
TinySharp Thumbnail Audit & Repair does not send images, Media Library data, or usage telemetry to TinySharp or another external service. Scanning and thumbnail regeneration happen inside your own WordPress installation using WordPress core image APIs and the image editor available on your server.