Why product image filenames become inconsistent
Catalog images often arrive from photo studios, suppliers, agencies, and internal teams. Their filenames may include camera defaults, spaces, uppercase extensions, version labels, or product names that no longer match the catalog. The storefront can still display an image, but the underlying media library becomes harder to search, review, and migrate.
A filename check creates a predictable baseline. It is especially useful when one product has several angles or when many variants share similar assets.
Checks included in the catalog audit
- Missing filenames and missing product handles.
- Spaces, uppercase characters, and underscores that break a chosen lowercase kebab-case convention.
- Duplicate image URLs that may indicate copied or misassigned rows.
- Image records that also have weak alt text or dimensions below your chosen baseline.
- A proposed normalized filename in the exported review CSV.
The proposed name is a starting point. Always confirm product identity, image order, and file extension before making a real change.
A practical naming pattern
A simple pattern combines a stable product handle with an image sequence, such as trail-bottle-01.jpg. Teams may add a meaningful view or color when it helps distinguish the asset. The most important rule is consistency: document one convention and apply it across new uploads.
Keep the source-to-product mapping
Do not rename a folder of images without preserving the relationship to product records. Use a review file that includes the original filename, proposed filename, handle, and image URL.
Separate detection from changes
First detect problems, then approve a plan, then perform the actual media update. This reduces the risk of broken references or accidental overwrites during a large cleanup.
Frequently asked questions
Does CatalogImage QA rename image files?
No. It flags naming issues and can export proposed filenames. Your original files remain unchanged.
Are lowercase kebab-case filenames required by Shopify?
The checker treats them as a practical consistency convention, not a universal platform requirement. Your team may choose another documented standard.
Will changing a filename improve SEO?
A descriptive, consistent filename can support a clean workflow, but it cannot guarantee rankings. Search performance depends on many page and site factors.
Related catalog image guides
Find naming problems before they spread.
Check a 25-row sample for free, then use a paid plan when regular catalog work needs larger audits and exports.
Audit image filenames