How to Add Alt Text in Shopify: Step-by-Step Guide

Why Alt Text Matters for Your Shopify Store

If you run a Shopify store, every product image, collection banner, and blog graphic is an opportunity to improve your search rankings, reach more customers, and stay compliant with accessibility laws. Alt text -- the short description attached to an image's alt attribute -- is the single most impactful piece of image metadata you can control. Here is why it matters.

SEO Benefits

Google cannot "see" your product photos. It relies on alt text to understand what an image contains and decide whether to surface it in Google Images and standard search results. Stores that add descriptive, keyword-rich alt text to every image consistently see higher organic traffic from image search, which is especially valuable in e-commerce where shoppers frequently browse visually.

Accessibility

Screen readers used by visually impaired shoppers read alt text aloud to describe images. Without it, your store is essentially invisible to a significant portion of potential customers. In the United States alone, over 7 million people use screen readers regularly.

Legal Compliance

Web accessibility lawsuits under the ADA and similar legislation have increased sharply year over year. Retailers -- including Shopify merchants -- have been named in these suits. Adding proper alt text to all images is one of the most straightforward steps you can take to reduce legal exposure.

Step-by-Step: Adding Alt Text to Product Images

Product images are the most important images in any Shopify store. Here is how to add alt text to them manually through the Shopify admin.

1. Log in to your Shopify admin at your-store.myshopify.com/admin.
2. In the left sidebar, click Products.
3. Select the product whose images you want to edit. You will land on the product detail page, which shows the product title, description, pricing, and a media section displaying all uploaded images.
4. In the Media section, click on the image you want to add alt text to. A modal (overlay window) will appear showing the full-size image.
5. You will see a text field labeled Alt text (sometimes labeled "Image alt text") beneath or beside the image preview. Click into that field.
6. Type a concise, descriptive phrase that explains what the image shows. For example: Red leather crossbody bag with gold chain strap on white background.
7. Click Save or Done to close the modal, then click Save on the product page itself to persist your changes.

Repeat this process for every image on the product. If a product has five images, you need to open each one individually and enter alt text separately. Shopify does not provide a way to bulk-edit alt text for multiple images on the same product page.

Tips for Writing Good Product Alt Text

• Be specific. "Shoe" is unhelpful. "Men's navy suede Oxford shoe, side view" is much better.
• Include relevant keywords naturally. If you sell handmade candles, mentioning "soy wax candle" in the alt text helps with SEO.
• Skip filler phrases like "image of" or "photo of." Screen readers already announce that the element is an image.
• Keep it under 125 characters. Some screen readers truncate longer strings.

Step-by-Step: Alt Text for Collection Images

Collection pages in Shopify can have a featured image that appears at the top of the collection. Adding alt text here is slightly different from product images.

1. In your Shopify admin, go to Products > Collections.
2. Select the collection you want to edit.
3. On the collection detail page, scroll down to the Collection image section on the right side.
4. If an image is already uploaded, click on it. You will see an Alt text field appear, or an "Edit" option that reveals the field.
5. Enter a description of the collection image. For example: Summer 2026 women's sandal collection displayed on a beach backdrop.
6. Click Save.

Because most stores have far fewer collections than products, this step is manageable to do manually. However, it is still easy to overlook, so make it part of your workflow whenever you create or update a collection.

Step-by-Step: Alt Text for Blog Post Images

If you use Shopify's built-in blogging feature (or a blog app), your blog post images also need alt text.

1. Navigate to Online Store > Blog posts in the Shopify admin.
2. Open the blog post you want to edit.
3. In the rich text editor, click on an image that is already inserted into the post body. A small toolbar will appear above or below the image.
4. Click the image settings or Edit image option (the exact label varies by Shopify version).
5. In the dialog that appears, find the Alt text field and enter your description.
6. Click Done or Apply, then Save the blog post.

For the featured image of a blog post (the thumbnail that appears on your blog listing page), click the featured image in the sidebar of the blog editor and add alt text in the same way you would for a collection image.

Step-by-Step: Alt Text for Theme and Section Images

Many Shopify themes include hero banners, promotional tiles, and other images managed through the theme customizer. These often get missed.

1. Go to Online Store > Themes in the Shopify admin.
2. Click Customize on your active theme.
3. In the theme editor, select the section that contains the image (for example, "Slideshow," "Image banner," or "Image with text").
4. Click on the image block within that section. The settings panel on the left will display options for the image.
5. Look for an Image alt text field. Not all themes expose this field, but most modern Shopify 2.0 themes do.
6. Enter descriptive alt text and click Save.

If your theme does not expose an alt text field for a particular image, you may need to edit the theme's Liquid template code directly (see the Liquid tips section below).

Shopify Alt Text Limitations

While Shopify makes it possible to add alt text, the experience has significant limitations:

• No bulk editing. You must open each image individually. A store with 500 products and 3 images each means 1,500 manual edits.
• No AI suggestions. Shopify does not generate alt text for you. You need to write every description from scratch.
• No quality checks. There is no built-in tool to flag missing or low-quality alt text across your catalog.
• CSV export/import is partial. You can export products to CSV and edit the Image Alt Text column, but this only works for the primary product image, not variant or additional images.

For stores with more than a handful of products, manual alt text management becomes a serious time sink.

Manual vs. Automated: A Comparison

Using the AltFrame API to Automate Shopify Alt Text

AltFrame provides an API that analyzes your product images and returns optimized alt text. Here is a basic example of how to generate alt text for a Shopify product image using a curl request:

curl -X POST https://api.altframe.ai/v1/alt-text \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://cdn.shopify.com/s/files/1/0001/0001/products/red-bag.jpg",
    "context": "Product: Red Leather Crossbody Bag, Category: Handbags",
    "max_length": 125
  }'

The response includes a ready-to-use alt text string:

{
  "alt_text": "Red leather crossbody bag with adjustable gold chain strap and magnetic flap closure",
  "confidence": 0.96
}

You can then write that alt text back to Shopify using the Shopify Admin API:

curl -X PUT \
  https://your-store.myshopify.com/admin/api/2024-01/products/{product_id}/images/{image_id}.json \
  -H "X-Shopify-Access-Token: YOUR_SHOPIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "image": {
      "id": {image_id},
      "alt": "Red leather crossbody bag with adjustable gold chain strap and magnetic flap closure"
    }
  }'

For full catalog automation, AltFrame also offers a Shopify integration that connects directly to your store, scans all images, generates alt text, and writes it back -- no scripting required.

Shopify Liquid Template Tips

When building or customizing your Shopify theme, make sure your Liquid templates actually render the alt text you have worked so hard to add. Here are key patterns:

Product Images in Liquid

<img
  src="{{ image | image_url: width: 600 }}"
  alt="{{ image.alt | escape }}"
  loading="lazy"
  width="600"
  height="{{ 600 | divided_by: image.aspect_ratio | round }}"
>

Always use the | escape filter on alt text to prevent HTML injection from user-supplied content.

Fallback Alt Text

If an image has no alt text set, fall back to the product title:

{% assign alt_text = image.alt | default: product.title | escape %}
<img src="{{ image | image_url: width: 400 }}" alt="{{ alt_text }}">

Collection Images

{% if collection.image %}
  <img
    src="{{ collection.image | image_url: width: 1200 }}"
    alt="{{ collection.image.alt | default: collection.title | escape }}"
  >
{% endif %}

Common Mistakes in Shopify Alt Text

Even store owners who make the effort to add alt text often make mistakes that reduce its effectiveness. Avoid these pitfalls:

• Keyword stuffing. Writing alt text like "shoes buy shoes online best shoes cheap shoes" hurts your SEO rather than helping it. Google interprets this as spam.
• Using file names as alt text. Leaving alt text as IMG_4523.jpg or product-photo-1 provides zero value to search engines or screen readers.
• Identical alt text on every image. If a product has five photos from different angles, each image should have unique alt text describing that specific view: front, side, detail, lifestyle, and so on.
• Leaving alt text blank on decorative images. If an image is purely decorative (a background pattern, a divider line), set alt="" explicitly. This tells screen readers to skip it rather than announcing "image" with no context.
• Forgetting about new products. Alt text is not a one-time project. Every new product you add needs alt text on every image. Without a process or automation in place, coverage degrades over time.
• Writing alt text that is too long. Aim for one clear sentence under 125 characters. If you find yourself writing a paragraph, you are overcomplicating it.

Next Steps

Adding alt text to your Shopify store is one of the highest-ROI SEO tasks you can tackle. Start by auditing your existing catalog -- check how many images are missing alt text entirely. For stores with a small number of products, working through the manual steps above may be sufficient. For larger catalogs, automating with the AltFrame API will save significant time while producing more consistent, optimized results.

Whatever approach you choose, the key is to treat alt text as a required field, not an afterthought. Your search rankings, your accessibility compliance, and your customers will all benefit.