Gallery tile says File missing: cause and fix

You open a gallery you have not touched in weeks and one tile is grey, with the words File missing where the photo used to be. The storefront looks fine, nothing has errored, and nobody on the team remembers doing anything. This guide explains exactly what that label means, how it is different from the other two placeholders you can see on a tile, what shoppers are seeing in the meantime, and the two ways to clear it. It also covers the quiet part: why the gallery kept the caption, tags and position of an item whose picture is gone, and why that is the behaviour you want.

What a gallery item actually is

A gallery in Snug Gallery does not hold copies of your images. Each item is a pointer to a file in Content > Files in the Shopify admin, plus the things that belong to the gallery rather than the file: the caption, the alt text, the tags, the position in the order, and for videos the poster. The pointer is what lets the same photo appear in three galleries without being uploaded three times, and it is why storage never goes up when you add an image to a gallery. The trade-off is that a pointer can outlive the thing it points to.

When the editor loads a gallery it asks Shopify for the current state of every file it points to. Shopify answers with the file and its processing status, or with nothing at all if the file no longer exists. That second answer is where File missing comes from. The item is still in the gallery, but the file it referred to has been deleted from Shopify Files, by a person, by another app, or by a bulk clean-up.

Three placeholders, three different situations

A tile without a thumbnail can show one of three labels, and they call for different actions. Reading the label correctly saves a round of guessing.

Processing, or Processing video for a video item, means Shopify has accepted the upload and is still generating the sizes and formats it serves. Nothing is wrong. The editor checks back on its own and the preview appears when Shopify is done, usually within seconds for an image and a minute or two for a longer video. Leave it alone.

Upload failed means Shopify rejected or could not process the file. The details panel for that item says so and offers a button labelled Retry with another file. The original is not coming back; pick a different file or remove the item.

File missing means the upload worked at some point and the file has since been deleted. The item has no preview, the editor stops asking Shopify about it (there is nothing left to wait for), and the details panel shows a warning headed This file no longer exists in Shopify Files, with a note that the storefront skips the item. This guide is about that third case.

What shoppers see

Nothing, which is the point. The storefront block renders only items that have an image to show. A missing file produces no broken-image icon, no empty frame, no gap in the grid; the other items simply close up around it. A twelve-image grid with one missing file is an eleven-image grid.

This is why the problem can sit unnoticed for a while. Nobody reports a broken gallery because the gallery is not broken. The first sign is usually someone counting photos, or noticing that a product shot they expected in the lookbook is not there. If a gallery is important enough that a silent drop would matter, open it in the editor once in a while and scan for grey tiles; it takes a few seconds.

How the file got deleted

Snug Gallery never deletes files. Removing an item from a gallery removes the pointer and leaves the file in Shopify Files, as the guide on removing a gallery image spells out. So a File missing tile always means something else removed the file.

The usual suspects, roughly in order of how often we see them: a staff member tidying Content > Files and deleting files that did not look attached to anything (the Files page shows product and theme references, not app references); a storage clean-up app doing the same thing automatically; a product being deleted along with its media when the gallery item pointed at a product image; and a theme or app uninstall that removed assets it had uploaded. The Store activity log under Settings may show who deleted what, if the deletion was done by a person.

Fix one: upload a replacement

Click the grey tile to open its details. Under the warning there is a button labelled Upload a replacement. It accepts an image or a video, so an item that used to be a photo can become a short clip if that is what you have now. Pick the file and the item is re-pointed at the new upload. Its caption, alt text, tags and position are untouched, and the tile returns to showing Processing until Shopify finishes, then the new thumbnail.

This is the right choice when the item means something in the gallery: the third photo in a story, a tagged lookbook piece that filters rely on, an image with a caption someone wrote carefully. You replace the picture and keep everything built around it. If you still have the original file, upload it again and nobody will know it was gone. If you do not, upload the closest thing you have and edit the caption if needed.

Replacement works the same way for a video whose poster image was deleted. If the video itself is fine and only the poster is missing, the details panel offers Replace poster instead, and only the still image changes.

Fix two: remove the item

If the photo should not be in the gallery any more, or you have no replacement for it, remove the item from the gallery. The grid tightens up in the editor exactly as it already has on the storefront, and the positions of the remaining items shift up by one. Nothing else changes, because there was no file left to affect.

Removing is also the right answer when a gallery has several missing files after a big clean-up and you want a quick, accurate picture of what is left before deciding what to re-add. Clear the grey tiles, look at the gallery as shoppers see it, then add back what is missing from scratch.

Why the metadata is kept

It would be simpler for the app to drop an item the moment its file disappears. We chose not to, for two reasons. First, the deletion might be a mistake, and the item is the only record of where the photo sat and what was written about it. Keeping it costs nothing and makes recovery a one-click upload instead of a rebuild. Second, tags and positions are often the result of real work: a lookbook filtered by collection, a sequence that tells a story. Losing that silently because a file was removed elsewhere would be the wrong kind of tidy.

The storefront, on the other hand, should never show a shopper a placeholder for something you did not choose to show. So the two sides behave differently on purpose: the editor keeps the item and flags it, the storefront skips it.

Preventing the next one

Before deleting files in Content > Files, search for them in the galleries that might use them. The guide on Shopify Files versus app-hosted images explains why app references do not show on the Files page, which is the root of most accidental deletions.

If you use a storage clean-up app, check whether it can exclude files by tag or folder, and put gallery images somewhere it will not touch. And when a product is being deleted, remember that its images go with it; if a gallery borrowed one of them, re-upload that image as a standalone file first.

Frequently asked questions

Will the missing file come back if I restore it in Shopify Files?

Shopify Files has no restore for deleted files, so no. Uploading the same image again creates a new file with a new ID, and the gallery item still points at the old one. Use Upload a replacement on the item and pick the re-uploaded file; the caption, alt text, tags and position carry over.

Does a File missing item still use storage?

No. Gallery items were never copies, so they used no storage to begin with, and a missing one uses none now. The file that was deleted freed whatever space it occupied in Shopify Files when it was removed.

Can I bulk-replace several missing files at once?

Not in one action. Each missing item keeps its own caption, tags and position, so replacement is per item: open the tile, choose the file, repeat. If you would rather start over, remove the missing items and add the new files together through the normal add flow.

The tile says Processing, not File missing. Is that the same problem?

No. Processing means the file exists and Shopify is still preparing it; the preview appears on its own once it is ready. Only File missing means the file was deleted. If a tile has said Processing for more than a few minutes, reload the gallery once; if it changes to Upload failed, use Retry with another file.