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 need | Appropriate workflow |
|---|---|
| Add a detail photo and keep the gallery | Add to existing images |
| Replace a product's whole image set | Replace existing images, after a sample and backup |
| Change one hosted file while retaining its references | Check Shopify's native file replacement workflow |
| Edit crops, backgrounds, or dimensions | Prepare 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.
1. Save the old gallery and its context
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:
| Product | New files | Intended final gallery |
|---|---|---|
| canvas-tote | TOTE-001-01.jpg, TOTE-001-02.jpg | Two photos |
| linen-apron | APRON-002-01.jpg | One 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.
Compare the complete gallery before and after
| Test product | Before | Complete replacement ZIP | Expected after a successful replacement |
|---|---|---|---|
| canvas-tote | Old front, side and detail | New front and side plus the detail photo you intend to keep | The three submitted photos, with no old gallery associations remaining |
| linen-apron | Old front and back | New front and back | The 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.