Shopify Image File Names: Do They Matter?

Image file names are a small ranking signal and a permanent one on Shopify. Small, because Google treats the name as context rather than as content. Permanent, because Shopify keeps the name inside the CDN URL and the admin gives you no way to change it on a product image after it is uploaded.

That combination is why this is worth ten minutes before an import rather than a week of regret after one. IMG_4821.jpg on four hundred products is not a crisis. It is just the one image mistake you cannot quietly fix later.

Do image file names affect SEO?

Yes, modestly, and Google says so in plain words. Its image SEO documentation asks for names that are "short, but descriptive", gives my-new-black-kitten.jpg as better than IMG00023.JPG, and asks you to avoid generic names such as image1.jpg or pic.gif.

What that is worth in practice: the file name is one of several signals Google uses to work out what an image shows, alongside the alt text, the caption, the surrounding copy and the page title. It is not the strongest of them. It is the only one you cannot revise on Shopify, which inverts the usual priority order. Spend your effort on alt text and page copy, and get the name right the first time because you get one attempt.

Where does Shopify put the file name?

Directly in the URL. An image uploaded as merino-base-layer-charcoal.jpg is served from a cdn.shopify.com path that contains that exact name, and that URL is what appears in your page source, your sitemap, your feed and anywhere Google Images references the file.

So the name is public, permanent and copied into every system your catalogue touches. It is also the reason two habits cause trouble later:

• Camera names. DSC_0042.jpg, IMG_4821.jpg, WhatsApp Image 2026-08-14 at 09.13.jpg.
• Supplier names. Dropshipping and marketplace imports keep whatever the supplier's system called the file, which is usually a hash: H4a8f2c1b9e.jpg.

Neither says anything about the product, and neither can be corrected through the admin.

Can you rename a Shopify product image?

Not on the product. The product media panel lets you reorder images, edit alt text, crop, replace and delete. There is no rename.

Two things that look like a rename and are not:

Replace. Uploading a replacement keeps the entry in place, but it does not give you the chance to choose a new name, and the file's link changes.

The Files page. Files uploaded under Content, Files can be renamed by editing the URL handle, and Shopify warns that the previous URL stops working when you do. That is genuinely useful for theme assets and downloads, and it does not help here: product images live on the product, not on the Files page.

That leaves two real routes. Delete and re-upload with the right name, which loses the image order and any variant assignment, so it is a job for one product rather than four hundred. Or the Admin API, where the fileUpdate mutation accepts a new filename, keeping the same extension. Apps that offer bulk image renaming are using that mutation, and it is the only route that scales.

The words Shopify will not let a file name end with

A detail that produces a genuinely confusing bug. Shopify's CDN reads certain suffixes as image transformation requests, so an image file name cannot end with: pico, icon, thumb, testing, small, compact, medium, large or grande.

Which means oak-dining-table-large.jpg is not a valid file name, and wool-throw-medium.jpg gets a suffix appended by Shopify to avoid the conflict. Size words belong in the middle of the name, or written differently: oak-dining-table-180cm.jpg says more anyway.

A naming pattern that survives 400 products

The pattern matters less than having one, exactly as with tags. This one has held up:

product-name-variant-number.extension

For example merino-base-layer-charcoal-1.webp, merino-base-layer-charcoal-2.webp.

The rules underneath it:

• Lowercase, hyphens between words. Not underscores, not spaces. Spaces become %20 in the URL and make the name unreadable everywhere it is quoted.
• Strip accents and punctuation. Café becomes cafe. Anything else is an encoding problem waiting for the one system that handles it badly.
• Describe the product, not the shoot. The name is for whoever reads the URL, which includes Google. blue-1 describes nothing.
• Number the images rather than inventing words for them. -1, -2, -3 in the order they appear. Trying to name the angle produces back, rear, behind and back2 across a catalogue, in about a month.
• Keep it short. Three or four words plus a number. A file name carrying the full product title, the brand, the category and three keywords is the keyword stuffing Google's own image guidance warns against, and it looks like it in the URL bar.
• Do not repeat the SKU on its own. SKU-88231-4.jpg is the camera name problem with extra steps: precise, and meaningless to a reader.

File name or alt text: which does what?

They are different jobs, which is why doing one well does not excuse the other.

Alt text is the one that carries real weight, for accessibility first and for Google Images second, and it deserves the longer conversation in Shopify alt text. The file name is the cheap one you do at upload time and never think about again.

While you are in this part of the catalogue, the two other image decisions worth settling once are the dimensions you upload at, in Shopify image sizes, and the minimum Google Shopping will accept from January 2027, in Merchant Center image requirements.

FAQ

Do image file names matter for SEO? Modestly. Google asks for short, descriptive file names and gives my-new-black-kitten.jpg as a better example than IMG00023.JPG. The name is one context signal among several, and alt text and page copy carry more weight.

Can I rename an image after uploading it to a Shopify product? Not from the admin. There is no rename action on product media, and product images are not listed on the Files page, where renaming by URL handle is possible. The options are deleting and re-uploading the image, or using the Admin API's fileUpdate mutation, which accepts a new filename with the same extension.

Does the Shopify CDN URL contain the file name? Yes. The name you upload with becomes part of the public image URL, which is why it is worth getting right before the upload rather than after.

Why does Shopify change my image file name? Because it ends with a reserved word. File names cannot end with pico, icon, thumb, testing, small, compact, medium, large or grande, as the CDN reads those as transformation requests. Shopify appends a suffix to avoid the conflict.

Should I put keywords in image file names? One product name and a number is enough. Stuffing the name with keywords is what Google's image guidance warns against, and it makes the URL unreadable for no gain.

Is the file name more important than alt text? No. Alt text is read by screen readers, is a stronger signal for Google Images, and can be corrected at any time. The file name matters mainly because on Shopify it cannot.

---

The practical version of all this is that file names are decided at upload, by whatever put the image there. A camera, a supplier feed or an app, and only one of those three is thinking about the URL.

When Yikfy publishes an image to a product, it names the file after the product itself, numbered in order, so what lands in your CDN URLs reads like merino-base-layer-1.webp rather than a hash from a supplier's server. Variant images take the variant name too.

The limit, said plainly because the distinction is the point of this article: the alt text it writes is the product title, not a description of what the photograph shows. That is a reasonable default and it is not the same thing as a proper alt text, which describes the image. If Google Images matters to your store, the alt text is the field to go and write yourself.