After installation, follow these steps once. They take you from a fresh install to a converted library with verified delivery. The first part is for WebPix Pro; if you use WebPix Free, skip to the section "WebPix Free: first steps" further down.
WebPix Pro: first steps
Make sure your licence is active first. See Activate your WebPix Pro licence.
1. Check what your server supports
Open ARN WebPix → Settings → Format. Each format shows Supported on this server or Not supported on this server. For more detail, open Support → Health and Support → System, which list GD, Imagick and FFmpeg support, PHP memory and free disk space.
2. Choose the format and quality
On Settings:
- Format: WebP is the default and a safe start. AVIF gives smaller files but encodes more slowly. Both creates WebP and AVIF and uses more disk space.
- Quality: Balanced is the default and suits most sites. Choose High for photography and portfolios, or Smallest for the smallest files.
- Source files: JPG/JPEG and PNG are on by default. GIF, BMP, TIFF, PDF previews and video are off until you turn them on.
When you change a setting, a You have unsaved changes bar appears at the bottom. Click Save changes to apply it, or Discard to drop the change.
3. Review automation and speed
Under Settings → Automation, the defaults suit most sites:
- Convert new uploads: on
- Background worker: on, every 5 minutes
- Convert missing sizes on page view: on
- Smart worker: off
Under Settings → Performance, Balanced is the default. On shared hosting, choose Gentle. See Convert your library with background jobs for details.
4. Test a few images first
Before you convert the whole library, try a handful of representative images:
- Go to Media → Library in list view, select a few images and choose the bulk action WebPix: convert.
- Open ARN WebPix → Optimize → Inspector and click Pick an image from the media library. Compare the original with its copy and the real file sizes.
- If you want a different quality, change it in Settings, then use Regenerate on those images in the Library page.
5. Convert your existing library
- Open ARN WebPix → Optimize. The images waiting count shows how many images still need conversion. If a library check is running, let it finish.
- Check Output and Speed, then click Start conversion.
- Follow the job under Jobs. Use Pause, Resume or Cancel if you need to. Cancelling does not remove copies that were already created.
The job continues in the background after you leave the page, as long as WordPress scheduled tasks work. Keeping the page open makes it go faster.
6. Verify delivery
- Open ARN WebPix → Delivery & CDN. Replace image URLs is the default delivery method and works with page caches and CDNs.
- Clear your page cache and, if you use one, your CDN cache. Cached pages may still contain the old image addresses.
- Under Check a page, enter the address of a page with images and click Check. The result tells you how many library images on that page arrive as WebP/AVIF, for example "8 of 8".
- Open a few pages as a visitor and confirm that they look right.
7. Explore the rest
- Organize media with folders
- Describe images with Media AI (Pro)
- Cloud storage and CDN
- Switch from another optimizer and set exclusions
WebPix Free: first steps
Everything in WebPix Free is on one dashboard: ARN WebPix in the admin sidebar.
1. Choose your settings
In the Optimization Settings card:
- Output Format: WebP (default) or AVIF. AVIF needs AVIF support in GD or ImageMagick on your server; AVIF copies are made at a fixed standard quality.
- WebP Quality: 82 by default, adjustable from 1 to 100. A higher value means better quality and larger files.
- Batch Size: images per batch, 10 by default.
- Time Budget (seconds): maximum time per batch, 30 by default.
- Convert on upload: on by default.
Click Save Settings.
2. Convert your existing images
In the Bulk Conversion card, click Start Bulk Conversion. Progress is shown live. Use Pause, Resume or Cancel as needed. The job continues in the background when you leave the page.
To convert only some images, select them in Media → Library (list view) and choose the bulk action WebPix: convert.
3. Verify delivery
WebPix Free replaces the image addresses on your pages automatically once copies exist. To check:
- Clear your page cache.
- Open a page with images in your browser.
- Open an image in a new tab, or use your browser's developer tools. The address of a converted image contains
arn-image-optimizerand ends in.webpor.avif.
A copy that is larger than its original is never served, so a few images may stay JPG or PNG. That is expected.