Batch Conversion

Batch Conversion

Batch conversion scans your media library, identifies unconverted images, and processes them in a background queue. Your original images are never modified.

---

Table of Contents#

• How It Works
• Starting a Batch
• Compression Presets
• Quota & Limits
• Monitoring Progress
• Re-Optimizing Images
• Deleting WebP Variants

---

How It Works#

1. GetWebP scans your wp-content/uploads directory for JPEG, PNG, and GIF images.
2. For each image, it generates a .webp sibling and (if AVIF is enabled) an .avif sibling.
3. Files are processed by the background queue — the conversion does not block your admin UI or slow down your site.
4. A status column in the Media Library shows the conversion state of each attachment.

---

Starting a Batch#

1. Go to GetWebP in your WordPress admin.
2. Review the Unconverted images count.
3. Click Start Batch Conversion.
4. Use Pause to temporarily stop processing; click Resume to continue.
5. Click Cancel to stop and discard the current queue (already-converted files are kept).

---

Compression Presets#

GetWebP provides three named presets. You can change the preset before or between batch runs.

Preset quality values are fixed and cannot be changed without a minor version bump. See CHANGELOG for historical changes.

---

Quota & Limits#

Each conversion of one source image (all its thumbnail sizes) counts as one unit against your quota.

When the quota is exhausted:

• Batch processing pauses automatically.
• New uploads stop being auto-converted.
• Already-converted images continue to be served in WebP/AVIF.

Upgrade your plan at getwebp.com/pricing to increase your quota.

---

Monitoring Progress#

The batch dashboard shows:

• Processed / Total — images converted so far vs. total queued
• Quota Used / Remaining — live counter
• Current file — the image currently being processed
• Failed — images that could not be converted (hover for the error reason)

Failed images are skipped and do not consume quota.

---

Re-Optimizing Images#

To reconvert an image with a different preset:

1. Open Media Library (list view).
2. Hover the image row and click Re-optimize in the row actions.
3. Choose a preset in the modal and confirm.

You can also re-optimize an entire batch by clicking Re-optimize All in the GetWebP dashboard. This re-queues all previously converted images.

---

Deleting WebP Variants#

To remove WebP/AVIF files for a single image:

1. Open Media Library (list view).
2. Hover the image row and click Delete WebP in the row actions.

To remove all generated variants:

1. Go to GetWebP → Settings → Advanced.
2. Click Delete All WebP Files.

This only removes the .webp and .avif sibling files. Original images are not affected.