About this plugin
AttiaWebP helps site owners convert JPEG and PNG media library images into WebP (and optionally AVIF) using the image tools available on their own WordPress server.
The default mode is conservative: it creates WebP copies next to the original files and keeps the original JPEG/PNG files untouched. Optional server-level delivery can serve matching WebP/AVIF sidecar files without rewriting front-end HTML, WooCommerce product markup, widgets, or content.
Advanced replacement tools are included for site owners who want a one-image WebP media library. These tools are disabled by default and require explicit confirmation before deleting original JPEG/PNG files or generated image sizes.
Main features:
- Automatically create WebP files after new JPEG/PNG uploads.
- Optional AVIF sidecar generation alongside WebP when the server supports AVIF encoding.
- Bulk convert existing media library images in safe, time-budgeted batches with a live progress bar and a Stop button.
- Background conversion mode that keeps working on the server through WP-Cron after the browser tab is closed.
- Media Library integration: a WebP status column, per-image savings, a one-click Convert/Regenerate button, and a bulk action.
- Estimated bandwidth savings on the dashboard, calculated from real sidecar files on disk.
- Exclusion patterns to skip specific folders or file names during conversion.
- Cursor-based bulk processing designed for large media libraries.
- Upload-file statistics for JPEG/PNG, WebP, WebP sidecar conversions, and AVIF files.
- Optional server-level WebP/AVIF delivery through a managed uploads.htaccess rules block on Apache/LiteSpeed servers, plus a copy-paste Nginx example.
- WP-CLI commands for status, conversion, replacement, and marker resets.
- A small on-screen log of recent conversion errors.
- Optional single image mode for future uploads.
- Optional permanent replacement mode that updates media items to WebP and deletes old JPEG/PNG files after explicit confirmation.
- Quality control for WebP (default 82) and AVIF (default 60).
- Option to skip generated files when they are larger than the source file.
- No external API calls and no third-party tracking.
Important: Always create a full backup before using permanent replacement tools. Replacement mode deletes original JPEG/PNG files and generated image sizes after successful WebP conversion.
Developers
WP-CLI commands:
- wp attiawebp status – Shows support details, pending counts, and background state.
- wp attiawebp convert [--limit=<n>] [--force] – Creates WebP/AVIF sidecars for pending attachments.
- wp attiawebp replace --confirm=DELETE-ORIGINALS [--limit=<n>] – Runs the permanent replacement flow.
- wp attiawebp reset-markers [--which=sidecar|replace] – Clears conversion or skip markers.
Filters:
- aawo_conversion_quality( int $quality, string $source_path, string $target_mime ) – Adjusts quality per file or per target format.
- aawo_should_convert_file( bool $allowed, string $relative_path, string $absolute_path ) – Skips or allows specific files. The second argument is the path relative to uploads.
- aawo_delivery_rules( string $rules ) – Modifies the managed.htaccess rules block. The returned block must keep the BEGIN and END AttiaWebP markers.
- aawo_batch_time_budget( float $seconds ) – Changes the per-batch time budget for bulk processing.
- aawo_rating_notice_threshold( int $threshold ) – Changes how many WebP files must exist before the review invitation shows on the plugin screen. Return a very large number to effectively disable the notice.
Privacy
AttiaWebP does not send images, site data, or usage data to external services. All conversion work happens locally on the WordPress server.