SEO Guide · 2026

Shopify Product Image Alt Text for AI Agents: What Crawlers Read When They Can't See Your Photos

AI shopping agents don't download your product images — they read the alt text. Shopify's default alt text (product title on every image) tells crawlers nothing about what each photo shows. Here's how to write alt text that makes your catalog readable to AI.

How AI shopping agents interact with product images

There are two types of AI crawler behavior toward images:

For the majority of AI shopping agents, alt text is the complete image signal. A product with five images all carrying alt text "Wool Sweater" provides no more image information than a product with one image.

What Shopify does with alt text by default

Shopify's default alt text behavior depends on whether you've set it explicitly:

• Primary product image: Uses the product title if no alt text is set (e.g., "Merino Wool Crew Sweater").
• Secondary/gallery images: Often empty (alt="") unless explicitly set.
• Variant images: Often empty or uses variant title (e.g., "Blue / M").

The practical result: AI agents see the product name once (from the primary image), then nothing for all subsequent gallery images. The angle, detail, scale, context, and use-case information conveyed by those photos is completely invisible.

Alt text quality guide: what to write for each image type

ImageObject JSON-LD: reinforce alt text with structured data

Beyond the HTML alt attribute, add an ImageObject block inside your Product JSON-LD to give AI agents a structured image descriptor that survives HTML parsing issues:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "{{ product.title | escape }}",
  "image": [
    {
      "@type": "ImageObject",
      "contentUrl": "{{ product.featured_image | img_url: 'master' }}",
      "description": "{{ product.featured_image.alt | escape }}",
      "width": 1200,
      "height": 1200
    }
    {% for image in product.images offset: 1 %}
    ,{
      "@type": "ImageObject",
      "contentUrl": "{{ image | img_url: 'master' }}",
      "description": "{{ image.alt | escape }}"
    }
    {% endfor %}
  ]
}

The description field in ImageObject is read by AI agents as a richer image description than the HTML alt attribute alone. It accepts longer text (up to ~500 characters) where alt text is conventionally kept under 125 characters.

How to update alt text at scale

Option 1: Shopify Admin API (programmatic, unlimited scale)

# Update alt text for a specific product image via Shopify Admin REST API
# Requires read_products + write_products scope
curl -X PUT \
  "https://YOUR_SHOP.myshopify.com/admin/api/2024-01/products/PRODUCT_ID/images/IMAGE_ID.json" \
  -H "X-Shopify-Access-Token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"image":{"id":IMAGE_ID,"alt":"Merino wool crew neck sweater in Navy, front view"}}'

# For bulk: export product images CSV via Shopify admin > Products > Export,
# update the "Image Alt Text" column, then reimport.

Option 2: Shopify CSV import/export

Shopify's native product CSV export includes an "Image Alt Text" column. Export all products, fill in alt text in a spreadsheet, and re-import. Shopify will update only the alt text field without touching other product data.

Option 3: Shopify apps

Apps including TinyIMG, SEO Manager, and Booster SEO offer bulk alt text management with templates (e.g., automatically generate "{{product_title}} - {{variant_title}} - {{position}} view"). These are useful for large catalogs but tend to produce formulaic alt text — acceptable for coverage, less ideal for AI agent signal quality.

Alt text anti-patterns that hurt AI agent signals