Shopify Product Image Filenames: The SEO Naming Checklist for Product Photos

Why the filename is a real ranking signal

Google's Google Images SEO best practices explicitly call out the file name as one of the inputs Google uses to understand what an image shows — right alongside alt text and the text surrounding the image. A descriptive name gives Google a clue about the picture before a single pixel is decoded.

On Shopify, that signal sticks. When you upload to a product's Media section (see the Shopify Help Center on product media), Shopify keeps your filename as part of the CDN URL it serves. The descriptive name you set at export time ends up in the live image URL — and from there it can also flow into your Google channel, where Merchant Center's image_link requirements expect a clean, resolvable image URL.

Filenames are the companion to alt text, not a replacement for it. If you have not done the alt-text pass yet, do both together — see the Shopify product image alt text checklist.

The filename formula for Shopify product photos

One slug with three parts, joined by hyphens: product (what it is), attributes (color, material, variant), and context (the angle, scene, or detail this specific shot shows). Front-load the product so the most important word comes first, then add an extension.

Hero photo: tan-white-leather-low-top-sneaker-side.webp. Lifestyle photo of the same shoe: tan-leather-sneaker-studio-floor-lifestyle.webp. Same product, different file, because each image shows something different — exactly like the standard Shopify gallery sequence.

Three formatting rules do most of the work: lowercase only (uppercase creates duplicate-URL ambiguity), hyphens not underscores (Google treats hyphens as word separators and underscores as word joiners), and no spaces or special characters (spaces become %20 and characters like & or # can break the URL).

The Shopify filename checklist by image type

The infographic at the top condenses this table into one screen. Use the table below when you are actually naming the files. Each row is one image in the gallery.

Pair the file format choice with the right dimensions from the Shopify product image sizes guide so the file is named and sized correctly in the same pass.

The rename-before-upload workflow

The only cheap moment to name an image is before it is uploaded. This five-step pass keeps every file consistent without slowing the listing process down.

1. Export with the final filename. Name the file at export time in your photo tool or AI generator, using the product + attributes + context formula. This is the one moment the name is free to set.
2. Run a quick lint pass. Lowercase only, hyphens only, no spaces, no special characters, .webp where possible, and the product name first. A 10-second scan catches IMG_, _v2, and stray capitals.
3. Keep filename and alt text in sync. The filename and the alt text describe the same photo, so write them together. They do not need to be identical, but they should never contradict each other.
4. Upload to Shopify Media. Admin → Products → pick a product → Media → upload. Shopify keeps your filename as part of the served CDN URL, so the descriptive name ships with the image.
5. Check feed parity. Confirm the same well-named hero image flows through to your Google channel image_link. A clean filename helps the listing, the Merchant Center item, and Google Images all read the same signal.

How Shopify's CDN handles your filename

When you upload, Shopify serves the image from its CDN and keeps your filename as the readable segment of that URL. That is the good news: name it well once and the signal ships with every page view.

The catch is that the URL is minted at upload time. Changing a file's display name later does not rewrite the CDN URL Shopify already created. To actually change the URL segment you delete the image and re-upload the correctly named file — which can reset image order and variant associations. So the rule is simple: get the name right before the first upload, and you never have to redo it.

Variants and Google Shopping feed parity

Variant images get the least attention and the worst filenames. Name each one for the variant it represents — leather-low-top-sneaker-forest-green.webp — so the gallery, the variant picker, and your feed all line up.

Your hero file usually becomes the Merchant Center feed image, so a clean filename there reinforces the same signal across your store and Google Shopping. For the full feed-image story, see how to optimize Shopify product images for Google Shopping, and for the agent side, how to prepare product photos for AI shopping agents.

Six common filename mistakes Shopify merchants make

• Uploading straight from the camera or phone. Files like IMG_4821.JPG or DSC00231.jpg are the single most common product-image SEO miss. The camera filename carries no meaning and becomes a dead segment of the Shopify CDN URL. Rename before the upload, not after.
• Spaces, capitals, and special characters. Use lowercase letters, numbers, and hyphens only. Spaces become %20 in the URL, uppercase creates duplicate-URL ambiguity, and characters like &, #, or ( ) can break the link entirely. "Tan Sneaker (Final).JPG" should be tan-leather-sneaker.webp.
• Underscores instead of hyphens. Google reads hyphens as word separators and underscores as word joiners. tan_leather_sneaker is read as one token; tan-leather-sneaker is read as three searchable words. Always hyphenate.
• Keyword stuffing the filename. shoes-sneakers-footwear-best-cheap-leather-buy-online.jpg trips the same spam heuristics as stuffed alt text. Describe the one photo accurately in a handful of words and stop.
• Reusing one filename across the gallery. sneaker.webp, sneaker-1.webp, sneaker-2.webp wastes six chances to describe six different shots. Each image earns a filename that matches what it actually shows.
• Renaming after upload and expecting the URL to change. Editing the file's display name in some tools does not rewrite the CDN URL Shopify already minted. To change the URL segment you delete the image and re-upload the correctly named file — so it is far cheaper to name it right the first time.

Measurement plan

A filename pass is slow to show up in revenue but easy to verify on the surfaces it affects:

• Google Search Console — filter Search type → Image and watch impressions and clicks on product URLs after a renaming pass.
• Google Merchant Center diagnostics — confirm no image_link errors on the items you re-uploaded.
• Crawl / URL inspection — spot-check that live image URLs carry the descriptive segment, not IMG_ or %20.

Land the filename fix inside a full image program rather than as a one-off using the Shopify product photography conversion checklist.

FAQ