Skip to content
50% OFF $299 $599
Lock in
§ 2.5.2 ARTICLE

Image SEO · file naming

Squarespace image file names

Squarespace preserves a sanitised version of the uploaded filename in the rendered CDN URL2. A photo uploaded as IMG_5824.jpg ships with a generic URL fragment that helps no one. The same photo uploaded as kitchen-renovation-before-after.jpg preserves the descriptive slug in the URL, which Google reads as a content signal1. The rename takes five seconds and works for every image you upload going forward.

This is the smallest possible SEO lever — small impact per image, but it compounds across hundreds of images, and the cost is essentially zero. The discipline is renaming before upload, not after.

Why file names matter at all

Google's image-search documentation lists the filename in the URL as one signal among several that contribute to how the algorithm understands an image. The signal is small individually — significantly smaller than alt text or surrounding context — but it is free to add at upload time, and it compounds. A site with 500 product images, each named descriptively, has 500 small URL-level signals supporting image search visibility. The same site with images named IMG_4982, IMG_4983, IMG_4984 throws away every one of them.

Google's documentation1 is explicit: "Google uses the URL path as well as the filename to help understand your images. Consider organizing your image content so that URLs are constructed logically." The same paragraph recommends hyphens as the separator between words.

The file-name math

Small

ranking impact per image. File names are a minor signal compared to alt text and context.

Google Search Central · 2026-Q1
0 cost

renaming files before upload takes seconds and has no downside. Always worth doing.

Google Search Central · 2026-Q1
Compounds

the value scales linearly with image count. 500 well-named images > 5 well-named images.

Google Search Central · 2026-Q1

What Squarespace preserves and what it strips

Squarespace processes uploads through a sanitiser: spaces become hyphens, uppercase becomes lowercase, special characters are stripped, and the resulting slug is appended to a hash-prefixed CDN path. The descriptive part of your filename survives — that is the part you control. The hash prefix Squarespace adds is not editable, but it does not affect SEO because Google reads the human-readable slug in the URL, not the hash.

text Before and after — how Squarespace transforms upload filenames
 # Upload filename: "Kitchen Renovation Before-After.JPG" # Squarespace stores as:
https://images.squarespace-cdn.com/content/v1/HASH/.../kitchen-renovation-before-after.jpg
                                                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                                       this part is preserved from upload
# Upload filename: "IMG_5824.jpg" # Squarespace stores as:
https://images.squarespace-cdn.com/content/v1/HASH/.../img_5824.jpg
                                                       ^^^^^^^^^^
                                                       SEO-empty

The transform is deterministic: spaces → hyphens, uppercase → lowercase, special characters stripped or hyphenated. The good news is that any descriptive filename you choose ends up readable in the URL. The bad news is that you cannot rename an image after upload — to change the URL slug, you have to delete the image and re-upload the renamed version, which costs the existing image URL and any inbound link to it.

The naming pattern that works

Three rules cover almost every case. (1) Describe the image content, not the page topic. 'kitchen-renovation-before-after.jpg' is better than 'best-kitchen-renovator-nyc.jpg' on a kitchen image — the latter is keyword-stuffed, the former is descriptive. (2) Use hyphens between words, never underscores or spaces. (3) Keep it under 60 characters where possible. Longer names work but are harder to scan in the CDN URL.

text Good vs less-good file naming patterns
 # Good: describes the specific image
kitchen-renovation-before-after.jpg
marble-island-with-walnut-cabinets.jpg
brass-pendant-light-side-view.jpg
asheville-elopement-blue-ridge-mountains.jpg
# Less good: generic, keyword-stuffed, or upload-default
IMG_5824.jpg
DSC00123.jpg
best-kitchen-renovator-near-me-nyc-2026.jpg
photo-1.jpg

For Commerce product images specifically, the rename pattern can include the product code or SKU, separated by hyphens — brass-pendant-light-sku-1042.jpg works fine and helps the operations side track the asset. The SEO value is in the descriptive slug, not in the SKU.