ShopifyImage Upload

How to Bulk Replace Shopify Product Images

Replace product photo sets from a ZIP, check SKU matches, preserve a backup, and handle products that cannot be replaced automatically.

By PlainKits Editorial Team

October 30, 2026

Updated November 3, 2026

On this page

Refreshing catalog photography means deciding what should disappear as well as what should arrive. Adding new photos leaves the old gallery in place; replacing a gallery changes the set customers see.

For many existing products, PlainKits Bulk Product Image Upload can match files from a ZIP and replace their product image sets. Prepare the complete new gallery for each affected product. Replacement is not a one-for-one update of files with the same name, and it does not promise to retain existing image URLs or alt text.

Choose the right kind of change

What you needAppropriate workflow
Add a detail photo and keep the galleryAdd to existing images
Replace a product's whole image setReplace existing images, after a sample and backup
Change one hosted file while retaining its referencesCheck Shopify's native file replacement workflow
Edit crops, backgrounds, or dimensionsPrepare the edited files before uploading

Shopify documents its native controls in Adding product media. The ZIP workflow below changes product-image associations; it is not a general cleanup of Content > Files.

Back up the product images and keep the product records separately. Note gallery order, featured image, variant assignments, and alt text you need to recreate. An image ZIP alone does not preserve every product setting.

Keep the downloaded source and the replacement ZIP in different dated folders. Upload history is a record of work, not a one-click restore. Check the backup opens before proceeding.

2. Prepare complete product sets, not only changed photos

Suppose product canvas-tote has three photos and you only want to improve the front shot. A replacement ZIP containing one front photo makes that one photo the replacement set. Include the two still-needed angles too, or use an individual editing workflow instead.

This illustrative plan is a review sheet you maintain, not a CSV to import:

ProductNew filesIntended final gallery
canvas-toteTOTE-001-01.jpg, TOTE-001-02.jpgTwo photos
linen-apronAPRON-002-01.jpgOne photo

For filename preparation and first-time setup, use the ZIP upload guide. A parent directory alone does not provide SKU matching.

3. Review destinations before choosing replace

Start with a small set of representative products. Select SKU, barcode, handle, or supported product-ID matching. Inspect each file's destination; an included manifest can override the filename rule. Correct or exclude ambiguous matches before confirmation.

Compare the review against your intended final gallery per product. A green match means a destination was found; it does not mean a replacement has happened. Review the selected count and current usage terms, then choose replacement and confirm only the checked sample.

4. Know when replacement will stop

The current app checks existing variant-image links and stops automatic replacement where those links prevent a safe change. It also checks media capacity and unexpected gallery changes during the task. Do not remove variant assignments merely to force a batch through; review that product separately.

Replacement adds the new images before removing the old product-image associations after checks succeed. It is not an all-store transaction or a guarantee that every product will finish together. Avoid simultaneous gallery edits while the batch runs.

5. Inspect the result before retrying

Open History, then inspect each sample product in Shopify and on the storefront. Check the complete gallery, featured image, variant behavior, and alt text. The current uploader does not copy old alt text onto new files; plan a separate review of image descriptions.

If a product failed, read the error and verify its actual gallery before creating another task. In a new replacement task, include that product's complete intended set again; retrying only one failed photo as a replacement can remove photos you still need. If successful and failed products are mixed, do not repeat the whole batch blindly.

Once the sample passes, continue in manageable batches and record the products checked. Keep your original backup until the final storefront review is complete. See the Bulk Product Image Upload FAQ for supported sources and the distinction between adding and replacing.

Test productBeforeComplete replacement ZIPExpected after a successful replacement
canvas-toteOld front, side and detailNew front and side plus the detail photo you intend to keepThe three submitted photos, with no old gallery associations remaining
linen-apronOld front and backNew front and backThe two submitted photos

This is an illustrative acceptance sheet. Run these checks on a small batch in Bulk Product Image Upload, then record the actual task result and storefront review. A filename match alone does not establish successful replacement. If a product fails, inspect its current gallery before submitting its complete intended replacement set again.

Install Bulk Product Image Upload on Shopify.

Related guides