All articles
Shopify SEO · · 6 min read

Shopify Image Alt Text: A Guide for Merchants

Where to add alt text in Shopify, how to write it for several photos of one product, and how it differs from the image file name.

A merchant planning product imagery on a wooden desk with a notepad.
On this page

Shopify image alt text is a short written description of an image. It lets screen readers describe the picture to people who cannot see it, it appears when an image fails to load, and it gives search engines context about what the image shows. You add it in the Shopify admin by opening the product media or the image block, choosing the option to add alt text, and typing a brief, literal description.

If you leave it blank, you lose all of that. A store with hundreds of product photos usually has plenty of gaps, and filling them in is a straightforward fix.

Why alt text matters

Alt text is not a hidden keyword field. It is real HTML that assistive technology reads aloud. It also helps Google understand what an image shows, which affects how your product images appear in Google Images and in results. Write it for a person first. A description that is accurate and specific helps screen reader users and search engines at the same time.

How to add alt text in Shopify

Product images

  1. In your Shopify admin, go to Products and open the product.
  2. In the Media section, click an image to open its preview.
  3. Choose Add alt text, enter the description, and save.

Collection images. Open the collection, find the Collection image section, and edit the image's alt text.

Images in the theme editor. For an image banner or a featured block on your homepage, click the image block in the theme editor. The settings panel has a field for the image alt text. Use it rather than leaving it blank or repeating the section heading.

In bulk. Shopify's help center notes that alt text can be uploaded in a CSV file, which is the practical route for a large catalog.

File name versus alt text

They are different things and are written differently.

  • The file name is the name of the image file before you upload it, and it becomes part of the image URL. Use words separated by hyphens and no spaces, such as mens-leather-work-boot-brown.jpg, not IMG_9845_final_v2.jpg.
  • The alt text is a natural sentence or phrase for people. Use spaces, normal capitalization and normal punctuation. A hyphen is fine where it belongs in a word, such as "T-shirt".
A digital camera and tape measure on a photography studio floor.
Treat each product angle as a unique visual to describe.

Several photos of the same product

Using the same alt text for every image on a product page makes screen reader users hear the same description repeatedly and tells search engines nothing new. Describe what each photo shows. For a ceramic coffee mug:

  • "Front view of the speckled blue ceramic coffee mug showing the curved handle."
  • "Top-down view inside the speckled blue ceramic coffee mug showing the white interior."
  • "Bottom of the speckled blue ceramic coffee mug showing the unglazed clay base."
  • "A hand holding the speckled blue ceramic coffee mug on a wooden kitchen table."

This includes your product terms naturally and stays genuinely descriptive. Forcing search phrases into the field is keyword stuffing and does not help anyone.

Common questions

Is there a character limit?

Shopify's help center gives a maximum of 512 characters and recommends staying at 125 or fewer. Keep descriptions short and focused on what is visible.

What about decorative images?

If an image adds nothing for someone who cannot see it, such as a purely decorative divider, an empty alt attribute is the correct choice, because it tells assistive technology to skip it. Do not fill it with keywords.

Should I let an app write it for me?

Apps and tools can generate alt text at scale, but descriptions that are generic or wrong are worse than a short, accurate one you wrote yourself. If you use one, read what it produces before it is published.

Do logos and linked images need alt text?

Yes. A logo should say what the brand is, and an image that works as a link should describe where the link goes.

Find the gaps

Crawl your store and list images with missing alt text, then start with product images on your top-selling pages. You can combine this with the rest of a store review: see how to do an SEO audit on Shopify and the product page SEO guide. SEO Karbon's free Shopify SEO audit reviews on-page and content elements as part of 71 checks across 10 areas, with no login, and is a quick place to begin.

Next step

See how your own store scores

The free audit checks your store against the issues in this article — indexation, duplicate collections, page speed and everything else that holds a Shopify store back — and shows you what to fix first.