Seo product image alt filename
Moderate effortFound on 1% of audited stores.
Replace auto-generated filename-based alt text on product images with short, descriptive phrases that accurately describe what the image shows.
What it is
Every image on a webpage has an "alt" attribute — a short text description baked into the HTML code. When your ecommerce platform automatically names an image's alt text after its filename (e.g. "IMG_4823.jpg" or "product-blue-01_grande.webp"), that filename becomes what search engines and screen readers "see" instead of a meaningful description. Descriptive alt text — like "Blue cotton crew-neck sweater, front view" — tells both Google and visually impaired shoppers exactly what the image contains. Most platforms either leave alt text blank or copy the raw filename, and fixing this is a straightforward, high-impact task.
Why it matters
Google Images is a significant source of product discovery, and Google explicitly uses alt text as a primary signal to understand and rank images in search results — poor alt text means your product photos may never appear in image searches at all. Descriptive alt text also reinforces your page's keyword relevance, giving an additional ranking signal for organic web search. Beyond SEO, missing or nonsensical alt text is an accessibility failure: screen-reader users cannot understand your product images, which creates legal exposure under accessibility laws (ADA, WCAG, EU Accessibility Act) and alienates a sizable portion of potential customers. Fixing alt text across your product catalog is one of the highest-ROI, lowest-effort SEO improvements available to a store owner.
How to fix it
- Audit your current product images to identify those with filename-based alt text (strings ending in .jpg, .png, .webp, or containing underscores/hyphens with no natural language).
- For each product image, write a concise, descriptive alt text that includes the product name, key attribute (color, material, style), and viewpoint when relevant — for example: 'Blue cotton crew-neck sweater, front view'. Keep it under ~125 characters and avoid keyword stuffing.
- Edit each product image's alt field in your store admin or theme code — most platforms have a dedicated 'alt text' or 'image description' field in the product editor.
- For the primary (hero) product image, also ensure the alt text matches or complements the product page title to reinforce topical relevance.
- For variant images (different colors, sizes, angles), write unique alt text per image rather than reusing the same description.
- After saving, verify changes are live by right-clicking an image in your browser, selecting 'Inspect', and confirming the alt attribute contains your new descriptive text.
Fix it on your platform
Pick your platform for the exact steps.
How to fix seo product image alt filename on Shopify
- Go to Admin → Products and open a product.
- In the Media section, hover over a product image and click the three-dot menu (⋯) or the image itself.
- Click 'Edit alt text' in the pop-up dialog.
- Type your descriptive alt text (e.g. 'Blue cotton crew-neck sweater, front view') and click Save.
- Repeat for every image on every product. For bulk updates across a large catalog, use the Shopify Bulk Editor (Admin → Products → select multiple → Edit products) or a third-party app such as 'Alt Text' by Booster Apps or 'SEO Image Optimizer' by Hextom.
How to fix seo product image alt filename on Shopify Plus
- Use the same Admin → Products → Media → Edit alt text flow as Shopify.
- For catalog-wide updates, use the Shopify Admin REST or GraphQL API (productImageUpdate mutation, altText field) via a custom script or a Shopify Plus automation.
- Enterprise teams can also use a Metafield-based flow or a third-party PIM integration to push alt text at scale.
How to fix seo product image alt filename on WooCommerce
- Go to WordPress Admin → Products → open the product.
- Click the main product image (featured image) in the 'Product image' meta box on the right, then click the image in the Media Library popup.
- Fill in the 'Alternative Text' field in the Attachment Details panel on the right side of the Media Library.
- Click Update/Save to apply.
- For gallery images, click 'Product gallery', select each image, and fill in the same 'Alternative Text' field.
- For bulk updates across many products, install the 'SEO Optimized Images' plugin or use the 'WP Sheet Editor – Media Library' plugin to edit alt text in a spreadsheet-style view.
How to fix seo product image alt filename on BigCommerce
- Go to Admin → Products → View and open a product.
- Click the 'Images & Videos' tab.
- Click a product image thumbnail; an 'Image Description' field appears below it.
- Enter your descriptive alt text in the 'Image Description' field (BigCommerce uses this as the alt attribute).
- Click Save. Repeat for every image and every product.
- For bulk updates, export your product catalog via Admin → Products → Export, edit the 'image_description' columns in the CSV, and re-import.
How to fix seo product image alt filename on Wix
- Open the Wix Editor and navigate to the page containing the product image, or go to Wix Stores → Products and open the product.
- Click the product image to select it.
- In the 'Product Images' section of the product editor, hover over the image and click the Settings (pencil/gear) icon.
- Enter descriptive text in the 'What's in the image?' (alt text) field.
- Click Apply / Done and Publish your site.
- For store product images, you can also bulk-manage images via Wix Stores → Products → select a product → Media section.
How to fix seo product image alt filename on Wix eCommerce
- In the Wix dashboard, go to Store Products and open the product.
- In the Media section, click the image and then the pencil/edit icon.
- Enter descriptive alt text in the 'What's in the image?' field.
- Save and republish the site.
How to fix seo product image alt filename on Squarespace
- For product images: go to Commerce → Inventory, open a product, and click an image in the product editor.
- In the image editing panel that opens, locate the 'Filename' or 'Alt Text' field (labeled 'Alt Text' in Squarespace 7.1+) and enter your descriptive text.
- Click Apply and then Save.
- For non-product images: click the image block on any page, click the pencil/Edit icon, and fill in the 'Alt Text' field in the Image Settings panel.
How to fix seo product image alt filename on Squarespace Commerce
- Go to Commerce → Inventory and open the product.
- Click a product image, then select 'Edit' or click the pencil icon.
- Fill in the 'Alt Text' field and click Apply.
- Save the product. Repeat for all product images and variants.
How to fix seo product image alt filename on Webflow
- For e-commerce product images, go to the Webflow Designer → CMS → Products Collection and open a product.
- Click the product image field; the image settings panel opens on the right.
- Fill in the 'Alt text' field with your descriptive text.
- Save and publish.
- For images placed directly in the Designer canvas, click the image element, open the Settings panel (D key), and enter alt text in the 'Alt text' input.
- For bulk CMS updates, export the Products collection as CSV, add alt text in the alt column, and re-import.
How to fix seo product image alt filename on Webflow Commerce
- Open Webflow Designer → CMS → Products.
- Open each product, click the image, and fill in the 'Alt text' field in the asset/settings panel.
- Publish changes. For bulk updates, use the Webflow CMS CSV export/import workflow.
How to fix seo product image alt filename on Adobe Commerce (Magento)
- Go to Admin → Catalog → Products and open a product.
- Click the 'Images and Videos' section to expand it.
- Click the image thumbnail you want to edit; a detail panel appears.
- Fill in the 'Alt Text' field with your descriptive text.
- Click Save. Repeat for base, small, thumbnail, and swatch images.
- For bulk updates, use a CSV import via Admin → System → Import (use the 'Images' entity type with an alt column) or install an extension such as 'Image Alt Text' by MagePow.
How to fix seo product image alt filename on Magento Open Source
- Follow the same Admin → Catalog → Products → Images and Videos → Alt Text path as Adobe Commerce.
- For mass updates, use Admin → System → Data Transfer → Import with a CSV containing SKU and image alt columns.
How to fix seo product image alt filename on PrestaShop
- Go to Back Office → Catalog → Products and open a product.
- Click the 'Images' tab.
- Click an image to select it; a caption/alt text field appears.
- Enter your descriptive alt text in the 'Caption' field (PrestaShop uses this as the image alt attribute).
- Click the checkmark or Save. Repeat for each image and each product.
How to fix seo product image alt filename on OpenCart
- Go to Admin → Catalog → Products and open a product.
- Click the 'Image' tab.
- OpenCart does not have a native alt text field per product image by default; install the 'Image Alt Tag' or 'SEO Image Alt' extension from the OpenCart marketplace.
- After installing, the extension adds an alt text input next to each image in the product editor — fill it in and save.
How to fix seo product image alt filename on BigCommerce GraphQL
- Use the BigCommerce Catalog API (PUT /v3/catalog/products/{id}/images/{image_id}) with the 'description' field to programmatically set alt text for all product images.
- Alternatively, use the BigCommerce admin UI as described for BigCommerce above.
Does your site have this issue?
Run a free SEOLZ scan 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 baked into the HTML code. When your ecommerce platform automatically names an image's alt text after its filename (e.g. "IMG_4823.jpg" or "product-blue-01_grande.webp"), that filename becomes what search engines and screen readers "see" instead of a meaningful description. Descriptive alt text — like "Blue cotton crew-neck sweater, front view" — tells both Google and visually impaired shoppers exactly what the image contains. Most platforms either leave alt text blank or copy the raw filename, and fixing this is a straightforward, high-impact task.
Why does seo product image alt filename matter?
Google Images is a significant source of product discovery, and Google explicitly uses alt text as a primary signal to understand and rank images in search results — poor alt text means your product photos may never appear in image searches at all. Descriptive alt text also reinforces your page's keyword relevance, giving an additional ranking signal for organic web search. Beyond SEO, missing or nonsensical alt text is an accessibility failure: screen-reader users cannot understand your product images, which creates legal exposure under accessibility laws (ADA, WCAG, EU Accessibility Act) and alienates a sizable portion of potential customers. Fixing alt text across your product catalog is one of the highest-ROI, lowest-effort SEO improvements available to a store owner.
How do I fix seo product image alt filename?
Replace auto-generated filename-based alt text on product images with short, descriptive phrases that accurately describe what the image shows.
Authoritative references
- SEO Starter Guide — Google Search Central
- Google Images & alt text best practices — Google Search Central