Skip to content

Rollback

Every image optimized by Vibebun Image Optimizer has its original preserved. You can restore any optimized image to its original state with a single click.

When you click Rollback on an optimized image:

  1. The app retrieves the preserved original from storage
  2. Uploads it back to Shopify via a staged upload
  3. Replaces the optimized version using Shopify’s fileUpdate API (same URL is preserved)
  4. Polls until Shopify confirms the replacement
  5. Records the rollback in the optimization log

The image returns to its original size, dimensions, and quality. The CDN URL stays the same — no broken links.

By default, original images are preserved for 7 days after optimization. After that, the originals are automatically deleted to save storage space.

You can change the expiry period in Settings:

  • 7 days (default) — originals are kept for one week
  • 14 days, 30 days, etc. — extend the preservation window
  • 0 (forever) — originals are never deleted; rollback is always available

Once an original expires, the image’s status changes to “Expired” and rollback is no longer available for that image.

Rolling back an image does not count against your monthly optimization quota. You can roll back as many images as you want without affecting your remaining optimizations.

Rollback is available on all plans, including Free:

PlanRollback
FreeIncluded
BasicIncluded
AdvancedIncluded

You can roll back multiple images at once:

  • All plans: select individual images using checkboxes, then click Rollback selected in the sticky action bar
  • Advanced plan only: click Rollback all on page to roll back every optimized image on the current page

See the Bulk actions guide for details.

Expired originals are cleaned up in two ways:

  1. Lazy cleanup — runs automatically when you visit the Images page
  2. Scheduled cleanup — your store administrator can set up a daily cron job that calls the cleanup endpoint

Both methods only remove originals that have passed their expiry date. Images set to “forever” (0 days) are never cleaned up.

When you uninstall the app, all stored data is automatically purged — including preserved originals, optimization logs, and settings. This cleanup happens via Shopify’s app/uninstalled webhook.

If you reinstall the app later, you’ll start fresh with no optimization history.