Undo & Cleanup

Undo & Cleanup

GetWebP never modifies original uploads. Undo and cleanup actions remove generated WebP or AVIF copies tracked by the plugin, then WordPress can fall back to the original Media Library files.

---

Table of Contents#

• Before Large Runs
• Undo a Recent Run
• Retry or Rebuild
• Delete All Optimized Copies
• Attachment Deletion and Uninstall
• Caches After Undo or Cleanup

---

Before Large Runs#

Back up both:

• wp-content/uploads
• the WordPress database

This is normal WordPress operational hygiene before large media changes. Originals are not changed by GetWebP, but a backup gives you a clean rollback point for uploads, metadata, and cache integrations.

---

Undo a Recent Run#

Use run history when you want to undo one stored optimization run.

1. Open GetWebP in WordPress admin.
2. Open the recent runs or history area.
3. Find the run you want to undo.
4. Use the run's undo action.

Undo removes generated copies associated with attachments in that run and removes the stored history entry. Original uploads remain in place.

---

Retry or Rebuild#

Use retry when a run failed because of a temporary browser, network, permissions, or write issue.

Use rebuild when settings changed and you want new generated files with the current preset, AVIF setting, or max-width value. Existing generated copies stay until replaced or deleted by an undo or cleanup action.

---

Delete All Optimized Copies#

Use maintenance cleanup when you want to remove all generated files tracked by GetWebP.

1. Go to GetWebP -> Settings.
2. Open Maintenance.
3. Click Delete optimized copies.

This deletes tracked generated WebP and AVIF files and clears current optimization status for affected attachments. Original uploads remain untouched.

Run history may still be useful as a historical record, but frontend delivery stops using generated files that no longer exist.

---

Attachment Deletion and Uninstall#

When a WordPress attachment is deleted, GetWebP removes generated files it tracks for that attachment.

When the plugin is uninstalled, plugin options and GetWebP attachment metadata are removed. Generated files may remain in uploads unless you delete optimized copies before uninstalling.

For the cleanest uninstall:

1. Delete optimized copies from Settings -> Maintenance.
2. Clear page, CDN, and object-storage caches.
3. Deactivate and uninstall the plugin.

---

Caches After Undo or Cleanup#

After undoing a run or deleting optimized copies, purge:

• page cache
• CDN cache
• object-storage or offload cache
• browser cache when testing a public page

This prevents cached HTML, image URLs, or offloaded objects from continuing to reference files you removed.