The rules, verbatim
Shopify's SEO overview states: 'Image alt text is customizable via the media library.' Shopify's Optimize-site doc adds: 'Image file names cannot be modified after upload — must rename before upload or replace the image.' Shopify's Optimizing-for-AI doc names 'high-quality images with descriptive alt text' as one of the seven AI-input categories. The Catalog optimization doc names Images as the third of seven AI-input product fields.
Four facts, two surfaces. The alt-text surface is editable per image, post-upload, in the media library. The filename surface is locked at upload — once an image is uploaded with filename IMG_5847.jpg, that filename is baked in until the image is replaced. The pre-upload discipline is therefore as important as the post-upload alt-text writing.
§ 01 Where
Where alt text lives in Shopify
Two places. On a product, open the Media panel — each image has an Edit option, click it, and the Alt text field appears. Alternatively, open the store-wide Content > Files (formerly Settings > Files), find the image, and the Alt text field is on the image detail panel. Both surfaces edit the same underlying alt-text value. The theme renders the alt text into the img tag automatically.
Bulk-editing alt text is not natively supported in the admin UI — you edit one image at a time. For stores with thousands of images, the practical workflow is to use the Shopify Admin API or a third-party app to batch-update alt text. The standard pattern: export product CSV with image columns, fill in alt text in a spreadsheet, re-import. Native CSV import does support alt text via the image_alt column.
§ 02 Pattern
The alt-text writing pattern
8-12 words. Describe what's in the image as a buyer would describe it. Include the product noun. Skip 'image of' or 'picture of' (every alt-text guide tells you this, and they're right — screen readers announce 'image' before the alt text). Vary alt text across the gallery — the front view, the back view, the detail shot, and the lifestyle shot each have different descriptive content.
Example for a linen Roman shade product with five gallery images:
- "Linen Roman shade in natural, hung over a kitchen window above a stone sink"
- "Detail of cordless lift mechanism on natural linen Roman shade"
- "Natural linen Roman shade fully extended showing blackout liner edge"
- "Close-up of natural linen weave on Roman shade fabric"
- "Natural linen Roman shade installed in bedroom with morning light"
Each alt text describes a different visual emphasis. The product noun ('linen Roman shade') appears in every entry — that's intentional, not redundant. AI agents and visual search engines read every alt text and key on the product noun for visual disambiguation.
§ 03 Filename
The filename rule (and how to undo it)
Shopify's Optimize-site doc states the rule plainly: image file names cannot be modified after upload. The fix is to rename the file before uploading, or to delete and re-upload with the new filename. Themes typically expose the filename in the rendered img src attribute, which means file names are visible in source view and crawler-readable.
Pre-upload discipline: rename images in a sensible pattern before uploading. linen-roman-shade-natural-front.jpg is descriptive without being keyword-stuffed. natural-linen-roman-shade-blackout-cordless-best-price-deals.jpg is keyword-stuffed and counterproductive. The middle ground is what AI agents and Google read as natural.
§ 04 AI
How AI shopping engines use alt text
When ChatGPT, Perplexity, or another AI engine renders a shopping card for a Shopify product, it pulls the primary image and a caption. The caption is sourced from the image's alt text. Stores with no alt text get 'untitled image' or the filename in the card; stores with descriptive alt text get a clean caption that reinforces the product identity in the buyer's visual scan.
The same alt text also feeds Google's visual search and Google Lens results. Buyers searching by image (uploading a photo of a product they want to find a similar version of) trigger the visual search index, which uses alt text + filename + image features to rank candidates. A Shopify store with thoughtful alt text on every image is over-represented in visual search relative to its catalog size; a store with blank alt text is invisible to visual search regardless of image quality.
The 2026 reframe: alt text was always a ranking signal for Google Images. It is now a citation signal for AI shopping cards and a discovery signal for visual search. The investment compounds across surfaces with one write pass.
