TSO Image Master

Preguntas frecuentes

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. 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_tso_im_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 Overview, Scan duplicates groups Media Library files with the same MD5 hash so you can spot wasted space. It does not delete files automatically; review groups before removing anything.