Skip to content
SEOScanShopify SEOContent Quality
Medium SeverityContent Quality

Shopify Missing Image Alt Text: How to Fix Product Images for SEO

Search intent: fix · Updated February 2026

Direct Answer

Shopify product images missing alt text are a common SEO gap because Shopify uses the image filename as the alt attribute by default when no alt text is explicitly set - producing outputs like "DSC_4821.jpg" or "product-image-1.jpg" instead of descriptive text. The fix involves setting alt text on every product image through the Shopify admin (or in bulk via the Admin API), and ensuring your theme's image Liquid tags output the alt attribute correctly using image.alt rather than a hardcoded string.

Quick Diagnostic Checklist

  • View Source on a product page and search for alt= - are product image alt values descriptive or empty?
  • Click a product image in Shopify Admin - does the alt text field have a meaningful description or is it blank?
  • Does your theme Liquid use image.alt with a fallback (e.g. | default: product.title)?
  • Run a Wave or Axe browser extension audit on your top product page - how many alt text errors appear?

Not sure if your store has this issue?

Run a free scan to detect content quality problems instantly.

Free Scan

What This Issue Means

Alt text (the alt attribute on <img> tags) serves two functions: it describes images to screen readers for accessibility, and it tells search engines what an image contains. Google Images is a significant traffic source for e-commerce stores - product images with descriptive, keyword-relevant alt text rank in Google Images and image carousels in regular search results. Images with absent, auto-generated, or generic alt text (like the filename) are invisible to Google Images ranking and send weak relevance signals to the main search index.

What Causes It (Shopify-Specific)

1

Shopify defaults to filename when no alt text is set

When you upload a product image in Shopify without setting alt text, Shopify stores an empty alt value. Many themes then output the image with either an empty alt attribute (alt="") or fall back to the image filename. Neither is useful to search engines or accessibility tools.

2

Bulk product imports without alt text fields

CSV-imported product catalogues frequently lack an alt text column, or the alt text column is left blank. Thousands of products can be imported simultaneously with no alt text across any of their images.

3

Theme outputs image.alt without a fallback

When Liquid code uses {{ image.alt }} and the alt text hasn't been set in Shopify admin, the output is an empty string. Some themes don't provide a sensible fallback like the product title.

4

Alt text skipped during store migration

Stores migrated from WooCommerce, Magento, or BigCommerce often lose alt text during the migration process, as migration tools focus on product data and may not transfer image metadata correctly.

How to Detect It Manually

  1. 1Open a product page → right-click → View Source
  2. 2Search for "img" tags in the source - check the alt attribute value for product images
  3. 3If alt values are blank (alt="") or contain filenames (alt="IMG_4321.jpg"), alt text is missing or incorrect
  4. 4In Shopify Admin → Products → select a product → click on any product image - the alt text field appears as a modal
  5. 5Use a browser extension like Wave or Axe to audit alt text coverage across a page automatically

How to Fix It (Step-by-Step)

1

Set alt text per image in Shopify Admin

For individual products: Shopify Admin → Products → [product] → click any image → enter alt text in the popup → Save. Use a descriptive format: "[Brand] [Product Name] - [colour/material/angle]" (e.g. "Evermore Leather Bifold Wallet - Dark Brown, Open View").

2

Update image alt in your Liquid theme with a fallback

Ensure your theme's product image Liquid uses a product title fallback when alt text is empty.

liquid
{%- assign img_alt = image.alt | default: product.title | escape -%}
<img
  src="{{ image | image_url: width: 800 }}"
  alt="{{ img_alt }}"
  width="{{ image.width }}"
  height="{{ image.height }}"
  loading="lazy"
>
3

Bulk update alt text via the Shopify Admin API

For stores with hundreds of products, use the Product Images API endpoint (PUT /admin/api/2024-01/products/{product_id}/images/{image_id}.json) to set the alt field programmatically. Or use a bulk edit app like Ablestar Bulk Product Editor.

4

Prioritise high-traffic product pages first

Use Google Search Console → Performance → Pages to identify which product pages get the most impressions. Fix alt text on these pages first for maximum SEO impact, then work through the rest of your catalogue.

How SEOScan Detects This Issue

SEOScan fetches the full rendered page and audits all <img> elements for their alt attributes. Images with empty alt attributes (alt="") are flagged if they appear to be content images (not decorative). Images with alt text matching a filename pattern (e.g. ends in .jpg, .png, or contains underscored numeric sequences) are flagged as auto-generated alt text. The tool reports the count and percentage of product images with missing or inadequate alt text.

Example Scan Result

14 of 18 product images have missing or auto-generated alt textMedium

Description

Page: /products/leather-wallet. 18 product images found. 14 have empty alt attributes. 3 have filename-based alt text (e.g. "leather-wallet-DSC4821.jpg"). Only 1 has a descriptive alt text.

Impact

Google Images cannot categorise or rank 17 of 18 product images. Google Images is a high purchase-intent traffic source for product searches - missing alt text removes these images from consideration entirely.

Recommended Fix

Set descriptive alt text for each product image in Shopify Admin → Products → [product] → click image. Update your theme's Liquid to use alt text with a product title fallback.

Why It Matters for SEO

Google Images Traffic

Product images with descriptive, keyword-relevant alt text rank in Google Images for relevant queries. For visual product categories (clothing, furniture, jewellery, home decor), Google Images is often the highest-converting traffic source because buyers are searching by appearance.

Main Search Index Relevance

Alt text is a content signal for the main search index. When the text content of a product page is sparse, image alt text contributes additional keyword signals that help Google understand what the page is about.

Accessibility Compliance

Alt text is a WCAG 2.1 Level A requirement (Success Criterion 1.1.1). E-commerce sites in the UK are subject to accessibility legislation (Equality Act 2010) and missing alt text on product images represents a compliance gap.

Real-World Validation Signals

  • Shopify automatically uses the product title as the image filename when downloading from suppliers, but does not automatically populate the alt text field - creating a systematic gap across imported catalogues.
  • Stores that add descriptive alt text across their product image catalogue consistently see increased traffic from Google Images within 4–8 weeks of Google re-crawling the updated pages.
  • Accessibility auditing tools (Wave, Axe) report missing image alt text as the single most common accessibility issue on Shopify product pages.
  • Google's own documentation on Google Images SEO explicitly lists descriptive alt text as one of the three most important optimisations for image search visibility.

When this may not need fixing

If all product images already have descriptive, keyword-relevant alt text set in Shopify admin and your theme outputs them correctly, no action is needed. For deliberately decorative images (section backgrounds, icon graphics), using alt="" (empty) is the correct approach - do not add false-descriptive alt text to these.

Frequently Asked Questions

Q: Does Shopify automatically add alt text to product images?

No. Shopify stores the alt text you manually enter in the image admin. If you don't enter alt text, the alt attribute in the rendered HTML is typically empty or defaults to the image filename, depending on how your theme is coded.


Q: Should my image alt text contain my target keyword?

Yes, naturally. If your product is a 'dark blue wool scarf', your alt text might be 'Dark blue wool scarf - folded flat view'. Include descriptive, specific language that genuinely describes what the image shows. Avoid keyword-stuffed alt text like 'buy cheap blue scarves scarf UK' - this is flagged as spam.


Q: Do I need alt text on every image, including lifestyle shots?

Yes. Even lifestyle images (product in context/use) should have descriptive alt text. Use a description of the scene: 'Brown leather wallet on a desk next to car keys'. Decorative images (icons, dividers) should have alt="" (empty, intentionally) to indicate they are decorative.


Q: Can I use an app to add alt text automatically?

Apps like SEO Image Optimizer can generate alt text automatically using the product title and other metadata. This is better than nothing, but manually crafted alt text is higher quality. Use bulk apps as a fast solution for large catalogues, then manually refine alt text on high-priority products.

Check Your Store for This Issue

SEOScan automatically detects shopify missing image alt text: how to fix product images for seo and 4 related issues - with specific fixes for your store.

Run Free Scan

Related Issues