Skip to content

How to bulk edit image alt text in Shopify

Updated 30 Oct 2026 · 6 min read · Markdown

Through a CSV. Every product image is a row in the product export, and the alt text for that image is in the Image alt text column on the same row. Fill the column, import with "Overwrite products with matching handles" on, and every image gets its text. Shopify allows up to 512 characters and recommends 125 or fewer.

Start with an audit, not with writing. Imported catalogs usually have no alt text at all, and the number of empty images decides whether this is an afternoon in the admin or a job for the CSV and something that writes. The admin sets alt text one image at a time; Shopify does not document it as a bulk editor column. The overview of every bulk edit method lists which fields each method reaches.

Catalog audit listing product images and their alt text status
Start with the count: how many images have no alt text at all. That number decides which method is worth it.

Find images with no alt text

Products, Export, all products, CSV for Excel or plain CSV. Each image is its own row, with the image URL and the Image alt text column next to it. A product with five images is at least five rows sharing one URL handle. Shopify accepts up to 250 images per product, each referenced by an https URL.

Filter to rows that have an image URL and an empty Image alt text cell. That filtered list is the work, and its row count is the job size. Alt text is stored per image, so a product with eight images is eight rows to fill, not one.

Keep this export untouched as a copy. With CSV and the admin there is no history, and the file you started from is the only way back; how to undo a bulk edit in Shopify covers the other options.

What good alt text looks like

Alt text is the sentence a screen reader says instead of the image, and what search engines read when they cannot interpret the picture. Name the product and the thing shown. Do not start with "image of", do not repeat the store name, and stay under about 125 characters, the length Shopify recommends.

ProductWeakBetter
Hiking backpack, image 2Kestrel 40LKestrel 40L hiking backpack in olive, side pocket open
Ceramic mugimage of mugSpeckled white ceramic mug, 350 ml, with a wide handle
Linen shirtShirt shirt linen shirt best linen shirt saleSand linen shirt with a band collar, worn untucked
Sneaker, sole viewNorthline Store sneakerSole of the Trail Runner sneaker with a deep lug pattern
Gift box, image 3Gift boxBack of the gift box showing the ingredients list

A template like "Title, Color" fills the field with the same text on every image of a product. If the images differ, the texts should too.

Upload it back by CSV

Fill the Image alt text cell on each image row. Keep the image URL on every image row, keep URL handle and Title, and import with "Overwrite products with matching handles" on. The hard limit is 512 characters per alt text.

The rule that decides the rest of the import: a column you removed from the file keeps its value in the store, and a column you kept but left blank is overwritten as blank. For alt text that cuts both ways. A blank Image alt text cell on a row you did not mean to touch clears the text that was there.

  • Do not delete image rows to make the sheet shorter. They carry the image URLs, and a trimmed file plus overwrite is how merchants lose images.
  • One plain sentence per image. Keyword lists read badly to a screen reader, and search engines discount them.
  • Import ten products first and look at them on the storefront before the rest.

Writing hundreds of them

The CSV moves text; somebody still has to write it, and 3,000 images is 3,000 texts. Bulk-edit and SEO apps fill alt text from templates such as "{product title} {variant option}", which is fast and puts the same text on every image of a product. Some SEO apps now generate alt text with AI. Check whether the model looks at the image or only at the title, and whether you see the texts before they are saved.

ApiMate writes one alt text per image from the product it belongs to: title, product type, vendor and the image's position. "Write alt text for every product image that has none" leaves the texts you wrote by hand alone, checks each one against the length limit (125 characters by default), and shows every image with its new text before anything is saved. The model does not see the picture, so it names the product and does not invent an angle or a colour; an image that is "the back of the box" is one to refine by hand. Images Shopify failed to process are skipped and named. The free plan covers a small catalog, and the SEO titles, meta descriptions and alt text case has a recorded run: 9 images written, one broken image skipped.

Instruction

Write alt text for every Northline product image that has none. Name the product and the colour if the title has one. Under 125 characters.

Check it landed

Export again and filter for empty Image alt text cells on image rows. The count should be zero, or the number of images you chose to skip. Then open three products on the storefront and inspect one image each.

Alt text filled once goes empty again with the next supplier import, because new images arrive with the field blank. Run the same count monthly. In ApiMate, "How many product images have no alt text?" is a read: no approval, no write, and the answer is a count and the list. Alt text is often fixed in the same pass as product descriptions, which go through the Description column of the same CSV.

Questions

Can I bulk edit alt text in Shopify?+

Yes, through the Image alt text column of the product CSV, one image per row, imported with "Overwrite products with matching handles" on. Apps and ApiMate do it without a file.

Is alt text in the Shopify bulk editor?+

Shopify does not document alt text as a bulk editor column. Use the image details on the product page for one image and the CSV for many.

How long can Shopify alt text be?+

Up to 512 characters in the CSV. Shopify recommends 125 or fewer.

Does ApiMate look at the image?+

No. It writes from the product the image belongs to: title, type, vendor and position. It does not describe what it cannot see.

Explore More

Related

Run this on your own catalog

Install from the Shopify App Store. Every write shows its rows before it runs, and applied jobs can be reverted from history.