1) Server Requirements
Summary: WordPress 6.x, PHP 8.4, ImageMagick 7 with AVIF/WebP codecs, and the PHP
imagick extension enabled.PHP
- PHP 8.4 recommended (works with 8.1+).
- Extensions:
imagick,mbstring,json,fileinfo. - Recommended limits:
memory_limit≥ 256M,max_execution_time≥ 60,upload_max_filesize≥ 16M.
ImageMagick 7 + codecs
- WebP codec (via
libwebp) - AVIF codec (via
libheif+ AV1 decoder such aslibaomordav1d)
$ convert -version
$ identify -version
# Look for Delegates: heic/heif/avif/webp
$ php -i | grep -i imagick
# ImageMagick version: 7.x
# Supported formats include AVIF, WEBPWordPress → Tools → Site Health → Info → Media
# Or a phpinfo() page to confirm imagick is loaded
# and reports AVIF/WEBP support2) Installation
- WordPress → Plugins → Add New → Upload.
- Upload the ZIP Ultimate AVIF Converter → Install Now.
- Activate the plugin.
Do not uninstall after converting unless you restore originals. Delivery helpers run at runtime.
3) Initial Configuration
General Settings
- Mode: Start in Safe mode, verify, then enable Delivery.
- Formats: Prefer AVIF; enable WebP fallback. Auto-detect server support.
- Quality targets: Photo vs graphics profiles; skip tiny images and SVGs.
- CDN rewrite: Optional base URL rewrite for
src/srcset.
Delivery Options
<picture>injection with fallbacks- Lazy loading
- Async decode hint
Bulk Tools
- Dry Run
- Queue-based Convert with progress
- Restore Originals (per item / bulk)
- Logs & Metrics (CSV export)
4) Using the Converter
- Open Media → Ultimate AVIF Converter.
- Run Dry Run, fix warnings.
- Start Bulk Convert (keep tab open).
- Enable Delivery features and test.
Tip: If your theme already outputs
<picture>, disable injection and keep conversions + CDN rewrite only.5) Trial & Licensing
Trial
- 1 day WebP-only conversion.
- AVIF unlocks after license activation.
Activate a License
- Go to Media → Ultimate AVIF Converter → License & Trial.
- Paste your key (format
XXXX-XXXX-XXXX-XXXX). - Click Activate to bind to your domain.
Moving domains? Contact support to reset activations.
6) Bonus Pack — Included Free (Value €99)
Image Privacy & EXIF Check (Lite)
- Scans new uploads for GPS/camera/timestamps.
- Read-only; avoid privacy leaks.
Image Delivery Inspector (Lite)
- Overlay shows lazy-load, async decode,
<picture>, CDN/local.
Smart Alt Text Assistant (Lite)
- Suggests clean, human alt text; one-click apply.
- No AI tokens.
7) Troubleshooting
| Symptom | Likely Cause | Fix |
|---|---|---|
| “AVIF not generated” | ImageMagick lacks AVIF delegate | Upgrade IM7 with libheif + AV1; restart PHP-FPM. Verify with identify -list format | grep -i avif. |
| “WebP missing” | No libwebp at build time |
Install a WebP-enabled ImageMagick; restart services. |
| No AVIF/WebP on front-end | Delivery injection disabled, caches, or builder markup | Enable Delivery, purge cache/CDN, or disable injection if theme already outputs <picture>. |
| “Trial expired” after purchase | License not activated or domain mismatch | Paste exact key and Activate; request activation reset if moving domains. |
| REST 404 on activation | Security plugin blocks REST, wrong endpoint | Allow /wp-json/ and ensure endpoint is correct. |
| Conversion stalls | Low resources / timeouts | Increase memory_limit, max_execution_time; smaller batch size. |
| Write permission errors | Filesystem ownership/permissions | Ensure wp-content/uploads is writable (dirs 755 / files 644 typical). |
# Formats
identify -list format | egrep -i "AVIF|HEIC|HEIF|WEBP"
# PHP imagick
php -i | grep -i imagick
php -r "echo phpversion('imagick').PHP_EOL;"# WP debug (wp-config.php)
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);8) Frequently Asked Questions
No. The plugin can inject
<picture> automatically. You can also keep your theme’s output and only use conversions.No. Originals remain untouched. You can restore per item or in bulk.
The plugin will fall back to WebP. Enable only WebP until you upgrade ImageMagick.
Licensed domains receive in-dashboard updates.
Yes — request an activation reset. One active domain at a time per license.