Skip to main content

Your First Image Edit

This walkthrough runs a complete edit end to end: swapping the background layer on a set of t-shirts to a new seasonal design. It assumes you've finished the one-time data sync.

Before you start​

Make sure your layer PNGs share the same canvas size and alignment (this is what keeps your stacks lined up). If you already have a few backgrounds, garments, and prints, upload them to the Asset Library first — but you can also upload directly from a grid cell as you go.

Step 1 — Set your scope​

Open Bulk Image Edit from the app sidebar.

  1. In the Scope card, build a filter for the products you want to edit — for example Product type is "T-Shirt" and Tag contains "summer".
  2. Set Dedupe by to Color (the default — one image per color, shared across sizes).
  3. Set Layers to the depth of your stacks (e.g. 3: background, garment, print).
  4. Click Apply scope.

The scope collapses to a summary bar and the grid appears below.

Step 2 — Review the grid​

Each row is a product (expand it to see its variants); each color bucket shows its Current Image and a Next Image preview that's currently empty or matching the current image.

If a bucket's variants currently use different images, you'll see a warning on that cell — a single composite will replace all of them. Expand the warning to see exactly which images would be replaced.

Step 3 — Set the background layer for everyone​

To change one layer across the whole set in a single action, use a column swap:

  1. Click the ✎ (swap) icon in the Layer 1 column header.
  2. Pick your new summer background from the Asset Library, or upload a new PNG.
  3. Choose whether to skip locked cells, and pick the output format/quality if prompted.
  4. Confirm. The change is staged across every product in scope.

Step 4 — Fill in the other layers​

For per-product layers (like each design's garment color and print), click an individual cell to open the cell editor and pick or upload its image. Repeat for the layers that differ by product.

To protect a specific cell from a future column swap, use the lock icon — locked cells are skipped by column operations.

Step 5 — Preview​

Watch the Next Image column update live as you edit. For a closer look, click the per-bucket Preview (eye) icon to open a larger view. Inside that modal you can click Generate exact composite to render the byte-exact server version — the same image Apply will upload.

Step 6 — Create the job​

When the grid looks right, click Create Job ▾ in the title bar and choose:

  • Now — applies immediately.
  • Scheduled — pick a date and time (your store's timezone), with optional auto-revert.
  • Recurring — weekly/monthly/yearly, always paired with an auto-revert.

Choose your revert mode here too — whether the old images stay in your Shopify library (KEEP) or are removed and re-uploaded on revert (CLEAN). See Applying & reverting.

Click Create Job. An immediate apply takes you to the apply results page.

Step 7 — Track and revert​

The apply results page shows each product's before/after and live progress as the composites upload and attach. If anything looks wrong, the same page has a Revert button that restores the exact previous state within your retention window.

What's next?​