Troubleshooting
Diagnose common optimization, compatibility, queue, backup, and frontend delivery issues.
WebP is not generated
Check System Status. The server needs Imagick WEBP support or GD WebP functions. Also confirm WebP is enabled in Compression settings and the attachment is JPEG, PNG, or WebP.
AVIF is unavailable
AVIF depends on host libraries. Leave AVIF disabled if read or write support is missing.
Bulk queue stalls
Refresh queue status, pause and resume, then retry failed jobs. If failures continue, reduce server load, process fewer images at a time, and review PHP memory and execution-time values.
Images are skipped
Open the Media Library Vacuum column and read the skip reason. Common causes include SVG, animated GIF, excluded MIME type, size limits, filename patterns, missing files, or unsupported formats.
Restore is unavailable
Restore requires a backup. If backups were disabled when an image was optimized, there may be no restorable copy for that attachment.
Frontend does not show WebP or AVIF
Confirm generated derivatives exist, frontend delivery is enabled, and the theme outputs images through WordPress functions. Hard-coded URLs may not pass through plugin filters.