Seo product image alt filename
Moderate effortFound on 2% of audited stores.
Replace filename-based alt text on product images with short, descriptive phrases that accurately describe each image's content.
What it is
Every image on a webpage has an "alt" attribute — a short text description that lives in the HTML code. When a product image is uploaded without a custom alt text, most platforms automatically fill it in with the image's filename (e.g., `IMG_4821.jpg` or `product-blue-v2_FINAL.png`). This filename tells search engines and visually-impaired shoppers absolutely nothing useful about what's actually in the photo. Descriptive alt text, by contrast, reads like a caption: "Blue cotton crew-neck sweater, front view."
Why it matters
Google explicitly uses alt text to understand and rank images in Google Images search, which drives meaningful, purchase-ready traffic to product pages. Filename-based alt text wastes this ranking signal entirely — a competitor with a well-written alt text will outrank you for visual searches on the same product. Beyond SEO, alt text is a legal accessibility requirement in many jurisdictions (ADA, EN 301 549, WCAG 2.1): missing or meaningless alt text can expose your store to accessibility complaints and lawsuits. Fixing it is one of the highest-ROI, lowest-effort on-page SEO tasks available to a store owner.
How to fix it
- Audit your product images by opening a product page, right-clicking an image, selecting 'Inspect', and checking the alt= attribute in the HTML. A filename like 'DSC_1042.jpg' or 'product-red-01.png' confirms the problem.
- Write descriptive alt text that answers: what is the product, what are its key attributes (color, material, style), and what angle/view is shown? Keep it under 125 characters. Example: 'Red merino wool zip-up hoodie, side view' instead of 'red-hoodie-side-01.jpg'.
- Include your primary keyword naturally where it fits the description — never 'keyword-stuff' the alt field with a list of terms, as Google penalizes this.
- Update the alt text field in your platform's product image editor for every main product image and any additional gallery images.
- For new images going forward, rename files descriptively before uploading (e.g., 'red-merino-wool-hoodie.jpg') AND set the alt text field separately — both practices reinforce each other.
- After saving, re-inspect the HTML to confirm the alt= value now shows your descriptive text instead of the filename.
<img src="red-merino-wool-hoodie.jpg" alt="Red merino wool zip-up hoodie, front view">Fix it on your platform
Pick your platform for the exact steps.
How to fix seo product image alt filename on Shopify
- Go to Products → All products and open a product.
- In the Media section, hover over a product image and click the '…' (three-dot) menu that appears, then select 'Edit alt text'.
- Type your descriptive alt text in the field and click 'Save alt text'.
- Repeat for every image in the gallery, including variant images.
- For bulk updates across many products, use the free Shopify app 'Bulk Image Edit – Image SEO' (by Hextom) or export your product CSV, fill the 'Image Alt Text' column, and re-import via Products → Import.
How to fix seo product image alt filename on Shopify Plus
- Follow the same steps as Shopify above.
- For large catalogs, use the Shopify Admin REST API (PUT /admin/api/products/{id}/images/{image_id}.json) to programmatically update the 'alt' field via a custom script or a Shopify Plus automation workflow.
- Alternatively, use a bulk-edit app such as 'Bulk Image Edit – Image SEO' (Hextom) available in the Shopify App Store.
How to fix seo product image alt filename on WooCommerce
- Go to Products → All Products and edit a product.
- In the 'Product image' box (right sidebar), click the product's featured image to open the WordPress Media Library.
- In the 'Attachment details' panel on the right, fill in the 'Alt Text' field with your descriptive text.
- Click 'Update' to save.
- For gallery images, scroll to the 'Product gallery' meta box, click each thumbnail, and edit its Alt Text in the same Media Library panel.
- For bulk updates, install the free plugin 'SEO Optimized Images' or 'Image SEO' from the WordPress plugin directory to manage alt attributes at scale.
How to fix seo product image alt filename on BigCommerce
- Go to Products → View in the control panel and open a product.
- Click the 'Images & Videos' tab.
- Hover over an image thumbnail and click the pencil (Edit) icon.
- In the 'Image Description (Alt Text)' field, enter your descriptive text.
- Click 'Confirm' to save, then click 'Save' on the product page.
- Repeat for all product images. For bulk updates, use the BigCommerce V2 Products Images API or a third-party app such as 'SEO Image Optimizer' from the BigCommerce App Marketplace.
How to fix seo product image alt filename on Wix
- Open your Wix Editor and navigate to a product page.
- Click the product image to select it.
- Click 'Settings' (the gear icon) in the toolbar that appears.
- In the 'What's in the image? (Alt text)' field, replace the auto-filled filename text with your descriptive alt text.
- Click 'Apply' and publish your site.
- For Wix Stores products specifically: in your Wix dashboard go to Store Products → select a product → click the image → 'Edit' → update the 'Alt text' field in the image settings panel.
How to fix seo product image alt filename on Wix eCommerce
- From your Wix dashboard, go to Store Products and open a product.
- Click on the product image to enter the image editor.
- Look for the 'Alt text' or 'Image description' field and replace any filename-based text with a descriptive phrase.
- Save changes and republish.
How to fix seo product image alt filename on Squarespace
- Open a product page in the Squarespace Pages panel.
- Click on the product image block to select it, then click the pencil (Edit) icon.
- In the image editor, click 'Design' and then find the 'Alt text' field (labeled 'Alt Text' or 'Filename / Alt Text' depending on your version).
- Enter your descriptive alt text and click 'Apply'.
- For Squarespace Commerce products: go to Commerce → Inventory → open a product → click the product image → look for the alt text/caption field in the image editor that appears.
- Note: Squarespace 7.1 surfaces alt text in the image block settings; if you cannot find the field, switch to the 'Design' tab inside the image editor.
How to fix seo product image alt filename on Squarespace Commerce
- Go to Commerce → Inventory in your dashboard and open a product.
- Click the product image, then click the pencil (Edit) icon.
- In the image settings panel, locate the 'Alt Text' field and enter a descriptive phrase.
- Save and publish changes.
How to fix seo product image alt filename on Webflow
- Open your project in the Webflow Designer.
- Click the product image element on the canvas to select it.
- In the Element Settings panel on the right (the gear icon), find the 'Alt text' field.
- Replace the filename-based value with your descriptive alt text.
- For Webflow Ecommerce products: go to the CMS → Products collection → open a product item → find the image field → click 'Edit' on the image → update the 'Alt text' field.
- Publish your site after making changes.
How to fix seo product image alt filename on Webflow Commerce
- In the Webflow Designer, open the CMS panel → Products collection.
- Open each product item and click the product image field.
- In the image settings, update the 'Alt text' field with a descriptive phrase.
- Save and publish.
How to fix seo product image alt filename on Adobe Commerce (Magento)
- Go to Catalog → Products in the Admin Panel and open a product.
- Click the 'Images and Videos' tab.
- Click the image thumbnail you want to edit — a detail panel will expand.
- Find the 'Alt Text' field and enter your descriptive text.
- Click 'Save' on the product.
- For bulk updates, use a custom import script via the Magento REST API (PUT /V1/products/{sku}/media/{entryId}, updating the 'label' field, which maps to alt text), or use an extension such as 'Mass Product Actions' from the Magento Marketplace.
How to fix seo product image alt filename on Magento Open Source
- Follow the same steps as Adobe Commerce above.
- Navigate to Catalog → Products → open a product → Images and Videos tab.
- Click each image thumbnail and fill in the 'Alt Text' field.
- Save the product.
- For bulk operations, use a data-patch script or a community extension to update image labels (alt text) across multiple products efficiently.
How to fix seo product image alt filename on PrestaShop
- Go to Catalog → Products in your back office and open a product.
- Click the 'Images' tab.
- Click a product image to select it; a caption/alt text field will appear below or beside the image.
- Enter your descriptive alt text in the 'Caption' field (PrestaShop uses captions as alt text).
- Click 'Update' and then save the product.
How to fix seo product image alt filename on OpenCart
- Go to Catalog → Products in the admin and open a product.
- Click the 'Image' tab.
- OpenCart does not have a native alt text field per image — install a free extension such as 'SEO Image Alt Tags' from the OpenCart marketplace to add this capability.
- Once installed, follow the extension's interface to set descriptive alt text for each product image.
- Alternatively, edit your product image template file (catalog/view/theme/[your-theme]/template/product/product.twig) to output a dynamic alt attribute using the product name and option values.
Does your site have this issue?
Run a free SEOLZ audit to find seo product image alt filename — and every other issue — across your whole site in minutes.
Scan my site freeFrequently asked questions
What is Seo product image alt filename?
Every image on a webpage has an "alt" attribute — a short text description that lives in the HTML code. When a product image is uploaded without a custom alt text, most platforms automatically fill it in with the image's filename (e.g., `IMG_4821.jpg` or `product-blue-v2_FINAL.png`). This filename tells search engines and visually-impaired shoppers absolutely nothing useful about what's actually in the photo. Descriptive alt text, by contrast, reads like a caption: "Blue cotton crew-neck sweater, front view."
Why does seo product image alt filename matter?
Google explicitly uses alt text to understand and rank images in Google Images search, which drives meaningful, purchase-ready traffic to product pages. Filename-based alt text wastes this ranking signal entirely — a competitor with a well-written alt text will outrank you for visual searches on the same product. Beyond SEO, alt text is a legal accessibility requirement in many jurisdictions (ADA, EN 301 549, WCAG 2.1): missing or meaningless alt text can expose your store to accessibility complaints and lawsuits. Fixing it is one of the highest-ROI, lowest-effort on-page SEO tasks available to a store owner.
How do I fix seo product image alt filename?
Replace filename-based alt text on product images with short, descriptive phrases that accurately describe each image's content.
Authoritative references
- SEO Starter Guide — Google Search Central
- Google Images & alt text best practices — Google Search Central