Shopify product image alt text: a practical guide

By Charles · Published and updated

Illustration of a person reviewing product images on a laptop

To add Shopify product image alt text, open the product in Shopify admin, select its image, and save a brief description of what that image shows. Describe the details a shopper needs from that particular image, such as its colour, view or distinguishing feature.

If saved descriptions are not appearing correctly on your storefront, start a conversation about a theme issue. For loading and responsiveness, see our Shopify speed optimization guide. For category pages, see Shopify collection SEO.

Key facts

  • Shopify's media guide, checked 1 November 2026, says alt text describes media for assistive technology and can appear when media cannot load.
  • Shopify recommends brief descriptions of 125 characters or fewer; its stated maximum is 512 characters. Shopify Help Center, checked 1 November 2026.
  • The W3C images tutorial, checked 1 November 2026, says the appropriate text alternative depends on an image's purpose and context.

How do you add alt text to a product image?

You can edit it directly in Shopify admin; no code is needed for this step. Shopify's current product media instructions give these desktop steps:

  1. In Shopify admin, go to Products and select the product.
  2. Select a product media item to open Preview media.
  3. Choose Add alt text (or edit existing text), enter the description, then select Save alt text.
  4. Close the preview and repeat for the other relevant images.

In the Shopify app, open Products, select the product and its media item, then tap Information, enter the text and save. Follow the Shopify instructions for the final save in your app. Shopify also documents a product CSV option; review its import guidance and preserve a backup before changing catalog data.

What should product image alt text say?

Describe the useful information visible in the photo in its context. Name the product and add the detail that distinguishes this view when it matters; avoid keyword lists, promotional claims and details the picture does not show.

Example photo Example alt text
Front of a navy linen shirt Navy linen shirt, front view
Back of the same shirt Navy linen shirt, back view with pleat
Close-up of the fabric Close-up of navy linen shirt fabric and buttons
A bag shown open Tan leather tote with its zippered interior open
Shirt on a model Model wearing a navy linen shirt with rolled sleeves

These are examples: use only details visible in your own photos. A product name alone may be enough when it conveys the image's purpose, but repeating it for every gallery view can leave out useful differences. Shopify's accessibility guidance recommends descriptive alt text for product and content images.

What about decorative images and image links?

The right text depends on the image's job. For an informative product photo, describe what the shopper needs to know. For a purely decorative image, W3C recommends an empty alternative (alt=""); for an image acting as a link or button, the alternative should communicate its function. See the W3C decision tree. Do not assume clearing a Shopify field always produces the correct storefront markup: check the rendered result.

How do you check the storefront and theme?

Open the product page after saving and check each gallery image, including variant images, with a screen reader or browser inspection tools. The saved description should be available for the matching informative image in the context where it appears. Check that controls such as gallery buttons have understandable names and work with a keyboard too.

If the admin value is correct but the page exposes a filename, unrelated product title or no useful alternative, record the product URL, affected image, expected text and what you observed. A theme or app rendering the image may need investigation; don't assume the cause without checking. Shopify's theme accessibility guidance is a useful reference.

For changes to the surrounding theme, see our guides to custom Shopify theme sections and Shopify template changes. Explore our services if the issue needs theme work.

Frequently asked questions

Where do I add alt text to a Shopify product image?

In Shopify admin, open Products, select the product and its media item, then choose Add alt text and save it.

Should every product photo have the same alt text?

Describe what each informative photo contributes, such as a different view, colour or detail, instead of repeating a generic label.

Will alt text improve my rankings?

Descriptive alt text can help search engines understand an image, but it does not guarantee a ranking improvement. Google's image guidance recommends useful, contextual descriptions and avoiding keyword stuffing.

Do I need a developer to add alt text?

You can edit product media alt text in Shopify admin. A developer may need to investigate if the storefront theme does not output the saved text correctly.

If your theme is not displaying the saved descriptions correctly, tell Ecommerce Nerds about the theme issue.