Image Alt Text On Shopify: What To Write And Where It Goes
Alt text is the short description of a photo that screen readers read aloud and search engines use, and this article shows what to write and where to enter it in Shopify.
Before You Start
- You can edit products in your Shopify admin.
- You have the product's facts at hand: what it is, its color, its size, what the photo shows. Alt text should only describe what is really in the photo.
Alt text is a short piece of text attached to an image. A screen reader reads it aloud to a shopper who cannot see the photo. A search engine uses it to understand what the photo shows. It is also what appears if the photo fails to load. Shopify stores it with each photo, and your theme prints it in the page's HTML.
Why It Matters
Google's image guidance says it uses alt text along with computer vision to understand what an image is about, and that alt text acts as the link text when an image is a link. That matters on a collection page, where each product card's photo usually links to the product.
For shoppers who use a screen reader, a product photo with no alt text is a gap in the page.
What To Write
Describe what the photo shows, in plain words, as you would to someone on the phone. Google's guidance asks for useful, information rich text that uses keywords in context with the page, and warns against filling alt attributes with keywords, which it says may make a site look like spam.
Google gives a simple ladder of examples, from a missing alt, to "puppy", to "Dalmatian puppy playing fetch". The last one is best because it says what is in the picture.
Example. A store that sells ceramic plant pots has four photos of one pot.
Photo 1: "Moss green glazed ceramic plant pot, 20 cm, with matching saucer"
Photo 2: "Drainage hole in the base of the moss green ceramic pot"
Photo 3: "Moss green ceramic pot holding a fern on a windowsill"
Photo 4: "Close up of the crackle glaze on the moss green pot"
Each one says what that photo shows. None repeats the others word for word.
A few rules:
- Say what is in this photo, not what the product is in general. A photo of the base should say it shows the base.
- Use the product's real details: color, material, size, what is in the shot. Do not add facts that are not in the photo or on the product page.
- Keep it short. Shopify's help gives a maximum of 512 characters and recommends 125 or fewer.
- Do not start with "image of" or "photo of". Screen readers already say it is an image.
- Do not paste the same text on every photo. It tells the shopper nothing new.
- Do not leave a file name. "IMG_2041.jpg" is as good as no alt text.
If a photo is only decoration, such as a background texture in your theme, it does not need a description. That is set in your theme's code, not on products.
How To Add Alt Text To A Product Photo
These are the desktop steps from Shopify's help:
- From your Shopify admin, go to Products.
- Click the name of the product.
- On the product page, click a photo to open its preview.
- Click Add alt text.
- Enter your alt text, then click Save alt text.
- Click the X to close the preview.
- Repeat for each photo.
In the Shopify app on a phone: open the product, tap a photo, tap Information, enter the alt text, and tap Save.
Shopify's help also says the media editor may suggest alt text. Read any suggestion before you accept it, and correct anything the photo does not show.
Alt Text For A Collection's Image
Collections can have a featured image too. Shopify's keywords guide says you can add alt text to it from the collection's page in your admin, through the image's edit option. The exact button names have changed over time, so look for an edit or alt text option on the image itself when you open the collection.
Doing Many Products At Once
Shopify's product CSV file has an Image alt text column. You can export your products, fill in that column, and import the file again with Overwrite products with matching handles selected.
- Export the products and keep an untouched copy.
- Fill in
Image alt text. Check that each description sits on the same row as the image it describes. - Import the file and check several products on the live store.
Try it on a few products first.
Check The Theme Prints It
Alt text saved in Shopify only helps if your theme puts it in the page. Most themes do. To check:
- Open a product page in a private browser window.
- Open the page source (in most desktop browsers, right click and choose View page source).
- Search for the first few words of your alt text. You should find them inside
alt="..."on the photo's img tag. - Do the same on a collection page that shows the product. Product cards often use the first photo, so its alt text is the one that matters there.
If the alt text is in Shopify but not in the page, the theme is not printing it. That is a theme code change.
Collection Optimizer's Site Fixes screen lists photos with missing, repeated or file name alt text under Images, with a suggestion for each built only from words already on that product's page. Read each suggestion against the photo before you paste it, since the words come from the page, not from looking at the picture.
How You Know It Worked
- Opening the photo in the product's media shows your alt text.
- In the product page's source, the photo's img tag has an alt attribute with your text.
- No two photos of the same product share the same alt text, and none of them is a file name.
Sources
- Shopify Help Center: Adding alt text to product media Checked Nov 13, 2026
- Shopify Help Center: Adding keywords to your store Checked Nov 13, 2026
- Shopify Help Center: Using CSV files to import and export products Checked Nov 13, 2026
- Google Search Central: Image SEO best practices Checked Nov 13, 2026
If a step here no longer matches your admin, tell us at help@collectionoptimizer.com and we will check it again.