How bad image updates happen
Most bad updates aren't bad photos. They're good photos sent to the wrong place, in the wrong order, or at the wrong time. Knowing which one you have tells you where to start.
| What went wrong | What shoppers see | First move |
|---|---|---|
| Image pushed to the wrong product | A different item in the gallery or grid | Delete it from that product |
| Right product, wrong colourway | Swatch and photo disagree | Check variant image links |
| Draft sent as the featured image | Unfinished edit in collection grids | Reorder, then delete |
| A bulk tool replaced every image | Originals gone across many products | Stop the tool, recover from masters |
| Theme crop cuts the new image badly | Product clipped in the grid only | Fix the aspect ratio, not the product |
The last row matters because it isn't a rollback problem. If the image looks right on the product page and wrong only in collection grids, the theme is cropping it. Rolling back will hide the symptom and you'll hit it again next time. Our guide to theme crops and aspect ratios covers that fix.
The first ten minutes: triage before you touch anything
Don't start deleting. A hasty delete can remove the only copy of an image you'll later need. Open the product in Shopify admin and write down three things first:
- The full media list, in order. The image in position 1 is the featured image. It's the one collection grids, store search, social link previews and most product feeds use.
- Whether the original is still there. Look further down the gallery. A new image pushed to the front moves every other image down one place. It doesn't delete them.
- Which variants point at which image. Open each variant and check its image. If a variant was linked to an image you're about to delete, it will lose that link.
If you only have a moment, take a screenshot of the media list and each variant before you change anything. It's a crude record, but it's the only record you'll have of how the product looked before your fix.
Rolling back an added image (the easy case)
When the bad image was added next to the originals, rolling back is just reordering and deleting:
- In the product's media section, drag the original back to position 1. The storefront featured image changes as soon as you save.
- Reconnect any variants that were moved to the new image so they point at the right photo again.
- Delete the bad image. Do this last, so the product never has a gap.
- Check the original's alt text is still there. Reordering doesn't change it, but it's worth confirming while you're on the page.
- Load the live product page and a collection that includes it, in a private window so you aren't looking at a cached copy.
This is how Retouchable's Shopify push works. Sending a finished image to a product adds it with the filename, alt text and position you set. Choosing the featured position puts it first and moves your existing images down one place, so nothing is removed. Every push is also logged in the Shopify tab of your Retouchable library, grouped by product with a link to its admin page. If you're not sure which products got the wrong image, that list tells you. The steps for a normal push are in pushing images back to Shopify products.
Moving the original back to position 1 fixes what shoppers see straight away. After that, deleting the bad image is housekeeping. Doing it the other way round can briefly leave a product with no featured image, or the wrong one, while you work.
Recovering a deleted or replaced original (the hard case)
If the original was deleted, either by hand, by a bulk-edit app, or by a tool that replaces images instead of adding them, Shopify can't restore it. There's no media history and no recycle bin for product images. You need another copy of the file. Look in this order:
- Your own master files. The full-resolution exports from your shoot or retouching. If you keep these in one place, named by SKU, recovery takes minutes.
- The tool that produced the image. Editing and AI tools usually keep both the source and the result in their library. In Retouchable, the uploaded original and every finished version stay in your library after a push, so you can send the right one again.
- Your photographer's or studio's delivery. Delivery links expire, but many studios keep archives for a while. Ask early.
- Exports and backups. A store backup app, if you use one, or a recent product CSV. A CSV holds image URLs, not the images, and URLs of deleted files may stop working, so download them right away if they still load.
Bad image was added
- Original still on the product
- Alt text, filename and variant links still there
- Fixed by reordering and deleting
- Done in minutes, from Shopify admin
Original was replaced or deleted
- Shopify can't restore it
- File has to come from your own archive
- Alt text, filename, position and variant links rebuilt by hand
- SEO details are easy to lose along the way
When you upload the recovered file, restore everything that came with the original, not only the pixels. Use the same descriptive filename and the same alt text. Put it back in the same position and reconnect the same variants. A recovered image named IMG_4471.jpg with no alt text looks fine to shoppers, but your image search and accessibility work goes backwards. Our guide on alt text, filenames and image order covers what each one does.
Cleaning up the channels that copied the bad image
Your product page is the source, but it's rarely the only place the image appears. Anything that syncs from your catalog may have picked up the wrong featured image while it was live. Fixing Shopify starts the cleanup but doesn't finish it.
| Where it spreads | How it updates | What to do |
|---|---|---|
| Google Merchant Center / Shopping | On the next feed sync and image re-fetch | Check the product in Merchant Center; resync the feed if your channel app allows it |
| Meta (Facebook & Instagram) catalog | Through the sales channel's catalog sync | Confirm the catalog item shows the corrected image |
| Other marketplaces fed from Shopify | Depends on the connector | Some only send images when a listing is created, so update those by hand |
| Search engine image results | When the page is next crawled | Nothing to force; a correct page and sitemap is enough |
| Emails and ads already sent | They don't update | Replace the creative in running ads; sent emails can't be recalled |
Exact timings depend on the channel and your feed settings, so check each one instead of assuming. A feed that refreshes daily can show the wrong image for a day after your storefront is fixed. A paid campaign built on that image keeps spending until someone changes it. If the bad image showed the wrong colour or the wrong product, treat ads as urgent. A shopper who clicks one and lands on a page that doesn't match is likely to leave, and you've already paid for that click.
Shopping channels check that the image matches the product being sold. An image showing the wrong item or colour is the sort of mismatch that can get a listing flagged. Fix the source first, then check each channel's diagnostics for the affected products.
Making the next rollback cheap
Product images will go wrong again. Changes to how you send them decide whether the next fix takes two minutes or a whole afternoon.
- Add before you promote. Send a new image to the end of the gallery first, check it on the live page, then drag it to position 1. Shoppers never see an unchecked hero image, and the old one stays right there.
- Prefer tools that add over tools that replace. A tool that deletes the old image as it uploads the new one is tidy, but every push becomes impossible to undo. If you use one, back up masters before running it.
- Keep masters outside Shopify. Shopify is where you publish images, not where you store them. Keep full-resolution originals named by SKU in storage you control.
- Use version-aware filenames. A name like
linen-shirt-navy-front-v2.jpgtells you at a glance which version is live, and still describes the product for search. - Test bulk changes on one product. Run any bulk image app on a single product, check it, then run it on the rest. More on safe bulk work in bulk updating product images in Shopify.
- Keep a push log. Record which image went to which product, and when. When something looks wrong, a log turns "which products did we touch on Tuesday?" from an afternoon of guessing into a quick lookup.
The chart is a guide to effort, not a measurement, but the order holds. Each step down removes one of your safety nets.
A rollback runbook to keep handy
Save this as a checklist for whoever manages the catalog, so nobody has to work it out under pressure:
- Stop the source. Pause any bulk job, scheduled sync or automation that's still pushing images.
- List the affected products. Use your push log, the bulk tool's history, or recently edited products in admin.
- Record the current state. Take screenshots of the media order and variant links for each product.
- Restore the featured image. Drag the original back to position 1, or upload it from your masters if it was deleted.
- Restore the details. Put back the filename, alt text, gallery order and variant links.
- Remove the bad image. Only after the right one is in place.
- Check the storefront. Look at the product page, a collection grid and store search, in a private window.
- Check the channels. Look at Merchant Center, Meta catalog, marketplaces and running ads.
- Write down the cause. One line on what went wrong and what would have prevented it.
Most stores rarely need the whole list. When a bulk job goes wrong across hundreds of products, though, working through it in order is the difference between a messy afternoon and a week of finding the wrong photo on products you thought you'd fixed. If gallery order is part of the cleanup, controlling Shopify image position and gallery order covers the details.