Overview
Start here for the purpose, safety model, and documentation map for Vacuum Image Optimizer.
Vacuum Image Optimizer is a local WordPress image optimization plugin for media libraries that need smaller image delivery without depending on an external API. It creates WebP and optional AVIF derivatives, can optimize supported WebP source uploads, processes existing media through a queue, and keeps originals recoverable through a backup-first workflow.
The plugin is designed for careful production use. Defaults are conservative, Safe Mode is enabled by default, and the admin interface explains which server capabilities are available before you start.
Canonical route
The canonical documentation route for this product is /vacuum-image-optimizer/.
Product facts
| Field | Value |
|---|---|
| Product | Vacuum Image Optimizer |
| Current version | 1.0.1 |
| Type | WordPress plugin |
| WordPress.org | Official plugin directory |
| GitHub | Source repository |
| Project page | mcorucu.com project page |
| Documentation | https://docs.mcorucu.com/vacuum-image-optimizer/ |
| Text domain | vacuum-image-optimizer |
| PHP namespace | VacuumImageOptimizer |
| Runtime prefix | vacimg_ |
| License | GPLv2 or later |
Design philosophy
- Optimize locally with Imagick or GD instead of sending media to a remote service.
- Keep original files safe, with backups enabled by default.
- Prefer explicit compatibility checks over silent failure.
- Process bulk work in small batches so the admin stays responsive.
- Use WordPress-native hooks, metadata, settings, and media APIs.
- Make every risky format decision visible in the Media Library and reports.
Supported formats and engines
| Source format | WebP output | AVIF output | Source recompression |
|---|---|---|---|
| JPEG | Supported | Optional when server supports AVIF | No |
| PNG | Supported | Optional when server supports AVIF | No |
| WebP | Supported as source | Optional when server supports AVIF | Yes, when smaller |
| SVG | Skipped for safety | Skipped | No |
| Animated GIF | Skipped for safety | Skipped | No |
Vacuum uses Imagick first when the required format is available, then falls back to GD when possible. The System Status page shows read and write support for WebP and AVIF separately.
Setup Wizard and Safe Mode
The optional Setup Wizard helps new installations choose a safe starting profile. It can be completed, skipped, and relaunched from settings. Safe Mode keeps the plugin conservative by leaving destructive or high-risk behavior off and keeping backup-first decisions prominent.
Optimization workflow
The normal workflow is:
- Install and activate the plugin.
- Open Media -> Vacuum Image Optimizer.
- Review System Status and run the Setup Wizard.
- Choose a compression profile and optional AVIF/frontend delivery settings.
- Scan the Media Library from Bulk Optimize.
- Process batches, review skipped or failed items, and export reports when needed.
Documentation map
| Area | Start with | Use when |
|---|---|---|
| Getting Started | Installation, Quick Start | You are setting up the plugin for the first time. |
| Configuration | Compression Settings, Safe Mode | You are deciding how optimization should behave. |
| Media workflow | Bulk Optimize, Media Library | You are processing or reviewing real attachments. |
| Recovery | Backup & Restore, Backup System | You need to understand restore safety. |
| Technical Reference | Architecture, Optimization Pipeline | You are reviewing implementation or extending the plugin. |
| Support | FAQ, Troubleshooting | You need help diagnosing a site-specific issue. |