Skip to main content

Applying & Reverting

Applying is what writes your staged edits to Shopify: it composites each bucket, uploads the new image, and attaches it to the right variants — preserving every variant↔image link. Every apply also captures a snapshot so you can revert exactly.

Creating the job

Click Create Job ▾ in the title bar and choose when it runs:

  • Now — applies immediately and takes you to the apply results page.
  • Scheduled — runs once at a future date/time (store timezone). See Scheduled image edits.
  • Recurring — runs weekly/monthly/yearly. See Recurring image edits.

Apply always targets the entire frozen scope, regardless of any view filter you have active.

What happens on apply

For each color bucket, the app:

  1. Composites the resolved layer stack into a flat WebP/JPEG.
  2. Uploads it to Shopify as product media and waits until it's ready.
  3. Attaches that one image to every variant in the bucket (no file duplication).
  4. Captures a snapshot of the previous variant↔image state for revert.
  5. Swaps the new image in for the old on those variants.

Apply is idempotent and resumable — if it's interrupted, it picks up where it left off and never uploads duplicate media. Only one apply or revert runs per shop at a time.

Progress

The apply results page shows live progress (done / total buckets) plus a per-product before/after as composites upload and attach.

Revert

Every apply can be reverted within your retention window. Revert restores the captured snapshot exactly — it does not re-compute — so your products return to precisely how they were before the apply.

  • Trigger it manually from the apply results page, or set an auto-revert window when you create the job.
  • Recurring edits always pair apply with revert — the revert fires before the next recurrence, so a weekly badge is added and then cleanly removed each cycle.

Revert mode — KEEP vs. CLEAN

You choose how the old images are handled when you create the job:

Keep Shopify library (KEEP) — default

The previous image stays in the product's media gallery (detached from the variants, but still attached to the product). Revert simply re-attaches it.

  • Pro: fastest, safest revert — the original is always alive and ready.
  • Trade-off: your Shopify product gallery temporarily shows both the old and the new image side by side until you revert or remove the old one.

Keep Shopify clean (CLEAN)

The previous image is deleted from Shopify on a successful apply (only when no variant still references it), and its bytes are kept in our storage. Revert re-uploads the original from those stored bytes.

  • Pro: your Shopify media gallery stays tidy — no leftover old images.
  • Trade-off: revert does a re-upload, and originals are only kept for your revert window.
Pick the mode at create time

The revert mode is fixed when you create the job, because it decides how the apply backs up your originals. You can't switch it after the fact.

What's next?