Description
Most image plugins only compress. TSO Image Master also fixes what goes wrong. It automatically converts every upload to WebP, AVIF, JPG or PNG (with an undo backup) and compresses your PDFs. Then it helps you repair the rest of your media library: broken image URLs with one-click fix and undo, safe renaming that updates every link, orphan and still-referenced images, extra files, duplicates, unused image sizes that waste disk space, missing or hyphenated alt text, and oversized files.
It provides the following features from a single admin screen:
Overview — Site health metrics (image count, missing alt, TSO backups, space saved, server engines). Bulk-fill missing or weak alt text. Configure backup retention (backups of deleted images are never purged automatically) and watch the background optimize queue.
Image Optimizer — Convert images to WebP, AVIF (when GD supports it), JPG, or PNG. Set quality and dimensions, replace originals, and update content links (posts, custom fields, options, widgets and Elementor pages). Bulk optimize runs in the background via WP-Cron (5 images per batch). Choose how many images to show per page (21–105). Requires PHP GD (WebP strongly recommended).
Image Editor — Open any image with the Edit image button to crop (free or fixed ratios), resize, rotate, flip, straighten, adjust brightness, contrast, saturation and sharpness, apply black and white or sepia, and improve it automatically (levels, white balance and a soft S-curve). You can also add text, watermarks and logos, draw arrows and shapes, blur or pixelate areas, remove camera and location data (EXIF), compare before and after, zoom, and move to the next or previous image. It works on phones with pinch and drag. Save as a new copy (default) or replace the original keeping its name, format and ID; replacing keeps an automatic backup and a Restore button. Edits are made on your server and nothing is sent to external services.
Orphan Images — Three sub-tabs. Orphans detects Media Library images not used in posts, pages, widgets, meta, Customizer settings, FSE templates/parts/patterns, term or user meta, or menus; paginated scanning avoids timeouts on large sites. Referenced lists images without a parent post that are still in use (also those used by ID inside a gallery or image block) and shows exactly where, so you can attach them to their post or delete them. Backups & leftovers scans uploads for files WordPress does not know about (double extensions like image.jpg.webp, plugin backups, temporary files) and shows which TSO backups can still revert an image. Every deletion saves a backup of the original first.
Image Sizes — Finds image sizes (thumbnails) left behind by old plugins or themes that WordPress no longer registers or uses, grouped by size. Delete a whole size in one click: every deletion saves a backup zip you can download, restore or delete, and files used by another size or by the main image are never removed. Sizes turned off in TSO Swiss Knife are marked, and thumbnail, medium and large can never be deleted.
SEO & File Names — Edit title, alt text, caption, and description for any image. Rename files using SEO-friendly slugs (lowercase, no accents, hyphens instead of spaces). All internal links are updated automatically. Each image gets a colour-coded badge per SEO gap (missing or generic alt, file-name-like alt, generic file name, missing title), and “Needs SEO first” sorts the list by how much search engines rely on what is missing.
PDF Compressor — Reduce PDF file size in the Media Library using GhostScript (recommended) or the Imagick PHP extension as a fallback. The original URL never changes.
Auto-Optimizer — Automatically optimize new uploads with your chosen format and quality. Optional: skip already-small WebP/AVIF files, and fill missing alt text on upload (even when auto-optimize is off). Each image is processed only once so regenerations do not re-trigger optimization.
Media Library — Row action and bulk action to queue images for background optimization, plus a short note on the attachment screen.
Repairs — Four sub-tabs. The inconsistent URL detector; attachment repairs (broken paths, MIME types, ghost attachments, and a Missing sizes tool that relinks, regenerates or removes image sizes listed in the metadata whose file is not on disk); Duplicate images, which groups identical files and lets you merge or delete the extra copies after review; and the removal backups, to undo a “Remove from content” action.
History — Audit log of optimizations, renames, SEO updates (with field details), PDF compressions, and related actions. Filter by action type, date range, and filename. Configurable automatic cleanup.
URL Fixer — Scans public content (posts, pages, and custom post types) for broken image URLs after format conversions (e.g. .jpg still referenced after conversion to .webp). Renders blocks and shortcodes when needed so embedded images are detected. Finds replacements and updates the database in one click; can also remove broken references when no fix exists.
Cache Compatibility — After operations that change file URLs or content, the plugin purges LiteSpeed Cache, WP Rocket, W3 Total Cache, WP Fastest Cache, Breeze, SiteGround Optimizer, and Autoptimize when they are active.
Requirements
- PHP 7.4 or higher (tested up to 8.3)
- WordPress 6.2 or higher (tested up to 7.1)
- PHP GD library with JPEG, PNG, GIF, and WebP support (AVIF output needs GD with
imageavif()/imagecreatefromavif()) - GhostScript (optional, required for best PDF compression)
- Imagick PHP extension (optional, fallback for PDF compression)
Source Code
The source code for this plugin is entirely human-readable. The file admin/js/admin.js is unminified, unobfuscated source code. No build tools are required. All translation strings are passed from PHP via wp_localize_script().
Translations
The plugin interface is already translated into the following languages (included in the plugin):
- English — default
- Català (Catalan) —
ca - Español (Spanish) —
es_ES
If you would like to contribute a translation into another language, you can do so at translate.wordpress.org.
Installation
- Upload the
tso-image-masterfolder to the/wp-content/plugins/directory, or install it directly from the WordPress plugin dashboard. - Activate the plugin through the Plugins screen in WordPress.
- Go to Image Master in the admin sidebar to start using the plugin.
- (Optional) To enable PDF compression, install GhostScript on your server. Ask your hosting provider for assistance if needed.
- WebP output requires PHP GD. Ask your hosting provider for assistance if needed.
FAQ
Does the plugin modify original image files?
Only if you check the “Replace original” option. When replacing, the plugin saves a backup copy under wp-content/uploads/tso-image-master/ (mirroring your upload year/month folders when applicable). Backup files use a _tso_im_backup name pattern. You can revert from the editor modal or delete backups to free disk space. Empty backup folders are removed automatically after deletion. Backups are never stored inside the plugin folder.
Can backups be deleted automatically?
Yes. On the Overview tab you can set backup retention by maximum age (days) and/or maximum total size (MB). A daily cron purges old or oversized TSO backups (the backup zips made by the Image Sizes tab and the backups of deleted images are never purged automatically: delete them manually). The removal backups of the Repairs tab are small JSON files in uploads/tso-image-master/url-removal-backups/ and are not purged automatically either. Set both to 0 to disable automatic purge. You can also run Purge now from Overview.
What happens to my images if I uninstall the plugin?
Uninstalling the plugin removes the following data:
- Database: plugin options, the custom history table (
wp_*tsoimma_history), all plugin postmeta keys, and scheduled cron events. - Backup folder: the
wp-content/uploads/tso-image-master/folder and all backup copies inside it are deleted. - Original images: your actual image files in the uploads folder are never deleted. Only the plugin-created backup copies are removed.
Which output formats are supported?
WebP, JPG, PNG, and keep original. AVIF appears when your PHP GD build supports AVIF read/write. If AVIF or WebP is requested but unavailable, the plugin falls back to a supported format.
Why is AVIF disabled or missing?
AVIF needs PHP GD compiled with AVIF support (imageavif / imagecreatefromavif). Many hosts still lack this. Check Overview → server engines (GD AVIF). WebP remains the recommended default for broad browser and host support.
How does bulk / Media Library optimize work?
Selected images are added to a background queue processed by WP-Cron (about 5 images per batch). Progress appears on the Overview tab; you can cancel pending jobs. You can also queue from the Media Library row action or bulk actions.
Does the plugin work with caching plugins?
Yes. After operations that modify content or file URLs, the plugin calls purge helpers for LiteSpeed Cache, WP Rocket, W3 Total Cache, WP Fastest Cache, Breeze, SiteGround Optimizer, and Autoptimize when they are installed and active.
Can I use the plugin on a multisite installation?
The plugin has not been explicitly tested on multisite. It is designed for standard single-site WordPress installations.
The PDF compressor does not work. What should I do?
PDF compression requires GhostScript or the Imagick PHP extension on your server. The Overview and PDF areas indicate which engines are available. Contact your hosting provider to install GhostScript for best results.
I optimized an image and the new format weighs more than the original. What happened?
This can happen with images that are already well-optimized, very small images, or images with a lot of transparency or detail. The plugin will show a warning in this case. You can revert to the original using the backup. On Auto-Optimizer you can optionally skip WebP/AVIF files already under a size threshold (KB).
How does fill missing alt text work?
On Overview you can bulk-fill useful alt text for selected images (from title or humanized filename). On Auto-Optimizer you can enable fill-on-upload for new images that lack alt text. Fill-on-upload can run even when auto-optimize is disabled. Generic or weak alt values may be replaced when a better suggestion exists; humanized filename fills are treated as useful.
What does the duplicate scanner do?
On Repairs > Duplicate images, Scan duplicates groups Media Library files with the same MD5 hash and shows where each copy is used. You choose which copies to keep; Merge repoints the posts that used the other copies to the kept file and then deletes the redundant ones, and files can also be deleted or unlinked one by one. Nothing is changed automatically, and deletions cannot be undone.
What does the Missing sizes repair do?
Some images list a size (for example medium) in their metadata whose file is no longer on disk, which causes 404 errors for thumbnails. On Repairs, Missing sizes finds them and, without touching the original, relinks the size if the file exists with another extension, regenerates it if the size is still registered, or removes the stale entry. Every repair is logged in History.
Screenshots






Changelog
See CHANGELOG.txt in the plugin folder for older versions.
2.1.5
- Fixed: WordPress 6.7 no longer logs a notice that translations for this plugin were loaded too early.
- Fixed: The undo and redo buttons under the image now follow the same history as the ones in Rotate & flip.
2.1.4
- Improved: faster Optimize and SEO lists; they refresh by themselves after any change; “Extra files” is now “Backups & leftovers” and tells image editor backups apart.
- New: Visual image editor (“Edit image” button in the image window): crop, resize, rotate, flip, straighten, adjust brightness, contrast, saturation and sharpness, black and white or sepia, automatic improvement, text, watermarks and logos, arrows and shapes, blur or pixelate areas, remove camera and location data (EXIF), compare before and after, zoom, and move to the next or previous image. It saves a new copy or replaces the original (same name, format and ID) with an automatic backup and a Restore button.
- Fixed: Image window on phones now fits the screen and no longer scrolls without end; image thumbnails in the lists are sharper; Repairs no longer flags thumbnails that still exist.
2.1.3
- Improved: the language buttons have an AUTO option that follows the WordPress language; a language added later through a WordPress language pack is used instead of English.
- Improved: The PDFs and History searches now work like the images search: every word is found in any order, with or without hyphens (“fondo 3” finds “fondo-de-pantalla-3”).
- Improved: Numbers in the search match as numbers: “3” finds “3” and “3×4” but not “30” or “3d”; from 3 digits on it matches as a prefix (“202” finds “2026”).
