Guide
How to edit alt text in bulk on Shopify
Shopify gives you three places to put alt text and no way to write 800 of them. This is the practical route from "every product image has alt text" to "actually done", in the order that wastes the least time.
First: what counts, and what to skip
Every product image, collection banner and blog photo needs a short text alternative (WCAG 2.2, 1.1.1). Logos need the brand name. Pure decoration — divider lines, background textures, spacer images — should have an empty alt attribute (alt="") so screen readers skip them instead of announcing "image".
Where the surrounding text already names the product ("Aster Linen Shirt"), the image alt should describe what the photo adds: the colour, the cut, the view, the model, the setting. Repeating the product title eight times per colourway helps nobody.
1. The image editor (fine for ten images)
- Shopify admin → Products → open a product.
- Click an image → the Alt text field appears in the panel.
- Paste, save. It writes straight to the image's alt attribute on every page that renders it.
This is the safest method and the slowest. At roughly 25 seconds per image, 500 images is about three and a half hours.
2. The bulk editor (the underrated one)
- Shopify admin → Products → tick the products you want.
- Click Bulk edit. Product images are not a column there, but variant images inherit product image alt text — so set the product-level images first.
- For Files (Content → Files), the list view shows a Alt text column you can edit inline, twenty or fifty files per screen.
The Files view is where most stores should live for an afternoon: it is a grid of every uploaded asset with an editable alt field, no product-by-product clicking.
3. CSV export and import (for large catalogues)
Shopify's product CSV has an Image Alt Text column. Export the catalogue, fill the column for each Image Src, re-import. Two cautions:
- The import matches on Handle and Image Src. If your image URLs changed (Shopify re-encodes uploads), rows silently don't match.
- Import only the columns you changed — Handle, Image Src, Image Alt Text — or you risk overwriting titles and prices with blank values.
For a store under 200 images I'd still use the Files grid; the CSV round trip earns its keep past a few hundred.
4. The Admin API (for developers)
PUT /admin/api/2026-10/products/{product_id}/images/{image_id}.json with {"image":{"id":…,"alt":"…"}}, or the GraphQL productImageUpdate mutation. Files have their own mutation. Rate limits are generous for a one-off backfill: about two requests per second on standard plans. This is the route if you already have a dev on retainer.
The part nobody warns you about
All three methods assume you already have the sentences. That is the actual work: someone has to look at each of the 800 images and write a line that is accurate, under 125 characters, and not a copy-paste of the product title. It is the reason alt text stays missing for years.
We do that part. Point the free audit at your store, see what it writes for twenty of your own images, and if it's good, $99 gets the whole catalogue (up to 1,000 images across 40 pages) as a CSV in exactly this shape: page, image URL, current alt, new alt, and the HTML attribute to paste.
Check your store first — it's free
One page, twenty images described, a shareable report. No account.
Related: alt text examples by image type · why alt text matters · for agencies