When something needs attention, WebPix gives you the records to investigate it: health checks, system information, a readable log, a support file and, in WebPix Pro, WP-CLI commands.
Where to find it: ARN WebPix → Support (Pro), or the Maintenance card on the ARN WebPix dashboard (Free).
Health checks (Pro)
The WebPix header shows a health pill: Healthy, Check health or Needs attention. Open Support → Health for the details and click Run again to repeat the checks.
| Check | What it tells you |
|---|---|
| WebP encoding | Whether GD or Imagick can write WebP |
| AVIF encoding | Whether AVIF is available (Imagick with AVIF, or PHP 8.1+ GD with AVIF) |
| Background processing | When the worker runs next, whether it is overdue or off, and whether WP-Cron is disabled |
| Image delivery | The delivery method and the last Check a page result |
| Disk space | Free space on the server |
| PHP memory | The memory limit; 256 MB is recommended for large photos |
| Video (FFmpeg) | Whether video conversion is available |
| Other image plugins | Whether another plugin also changes image URLs |
Support → System lists the WebPix, WordPress and PHP versions, the PHP memory limit, GD and Imagick support for WebP and AVIF, FFmpeg and the copies folder.
Log and debug mode (Pro)
Support → Log shows recent log entries. Errors are always written to the log. Use Download to save the log or Clear to delete the log files.
Under Logging:
- Debug mode writes every step to the log. It switches itself off after 24 hours.
- Log each conversion records each conversion, only while debug mode is on.
- Keep history for sets how many days log files and the conversion history behind the Overview chart are kept (30 by default).
Download a support file (Pro)
Click Download support file at the top of the Support page. The file contains your system information, your WebPix settings, statistics and the recent log. It never contains your licence key, secrets or CDN tokens.
To prepare a useful support request:
- If the problem is hard to reproduce, turn on Debug mode, save, and reproduce the problem.
- Click Download support file.
- Note the affected page address, the steps you took and the exact error message.
- Open a ticket at support.arnsmart.com and attach the support file.
File verification (Pro)
WebPix Pro checks that its protected files match the released package. If a file no longer matches, WebPix pauses and lists the files. Restore the official files, for example by uploading the WebPix Pro package again, then click Verify now in Settings → ARN Center → Licences. The Files column there shows the latest result.
WP-CLI commands (Pro)
If WP-CLI is installed on your server, you can check and convert the library from the command line:
wp webpix status
wp webpix scan
wp webpix convert 123 124
wp webpix convert --all
wp webpix convert --all --regenerate
statusshows the output format, eligible, converted, partly converted, not converted, failed and skipped images, coverage and savings.scanchecks the files on disk and refreshes the library status; nothing is converted.convertconverts the given attachment IDs.--allconverts every eligible image that is not converted yet.--force(with--all) also re-encodes images that already have fresh copies.--regeneratedeletes the existing copies first and creates them again with the current settings.
Media on hold until approval is skipped.
Maintenance tools (Free)
The Maintenance card on the WebPix Free dashboard has three tools:
- Refresh Stats updates the statistics.
- Recalculate Inventory scans the media library again.
- Clear Old Logs removes this plugin's log entries older than 30 days.
What happens when WebPix is deleted
Deactivating WebPix changes nothing. Data is only removed when you delete the plugin, and only if you choose so beforehand.
WebPix Pro (Support → When WebPix is deleted):
- Remove settings and statistics (off by default): on delete, WebPix removes its tables, options, media folders, Media AI data and its licence on this site.
- Also delete the WebP/AVIF copies (off by default, needs the option above): deletes the
uploads/arn-nextgenfolder. - Original files are never touched. Image backups and watermark clean copies are kept.
- With Remove settings and statistics off, the licence stays: when you install WebPix again on the same site, it is active without a new activation code (Pro 3.0.2; earlier versions removed the licence on every delete). On a multisite network, the licence is removed if the option is on for any site.
WebPix Free (dashboard, Optimization Settings):
- Delete plugin data on uninstall (off by default): on delete, removes its settings, statistics and media folders.
- Also delete the WebP/AVIF copies (off by default, needs the option above): removes the copies in
uploads/arn-image-optimizer. - Original images and data of other plugins are never removed. The shared ARN Free AI settings are removed only when no other installed ARN Free plugin still uses them.
Note: Before you delete WebPix Pro, remove any watermark you no longer want (deleting the plugin does not remove it), and if you deleted local files after a cloud upload, run Bring files back and wait until it finishes.