How to Bulk Add Alt Text to Shopify Images

Can you bulk add alt text to Shopify images without buying an app? Yes: the product CSV has an Image alt text column, one row per image, and a re-import with overwrite on writes every line in one go. The Bulk Editor has no alt text column, and the product editor edits one image at a time. The image alt text character limit is 512, with 125 or fewer recommended by Shopify.

The real cost is not the import. It is writing the text. Say a store has 500 products and six images each: that is 3,000 lines of alt text, and at a minute per line it is a full working week.

This guide covers every way to bulk add alt text to Shopify images: the admin route, the CSV route, AI generation and the Admin API, with what each one can and cannot do. Run your store through the free alt text checker first to see how many images you are fixing.

Why Bulk Alt Text Matters Right Now

Alt text used to be a checkbox on an SEO audit. Three things have made it urgent.

Google Images is a real traffic channel

For product queries ("navy slim-fit blazer", "ceramic pour-over set", "gold hoop earrings") image results often sit above the fold. Google's image SEO documentation says it uses alt text, computer vision and the page's content together to understand what an image shows, and warns that stuffing the alt attribute with keywords may be treated as spam.

The part most guides miss: alt text does not directly lift your page in ordinary web results. It is an image signal. The win is the Google Images traffic itself, which for product catalogs arrives with buying intent already attached. The alt text and image search rankings guide goes into how that channel behaves.

Accessibility law is tightening

WCAG 2.2 Success Criterion 1.1.1 requires a text alternative for every meaningful image. The EU's European Accessibility Act lists e-commerce among the services in scope and has applied since June 2025. In the US, missing alt text is one of the easiest violations for an automated scan to flag before a demand letter.

If you sell to UK, EU or US customers, which most readers of this blog do, this is no longer optional.

Most of your competitors have not done it

The WebAIM Million 2026 analysis of the top million home pages found missing alt text on 53.1% of them, and 16.2% of all home page images had no alt attribute at all. Product pages deeper in a store are usually worse. Alt text is one of the few first-party signals you can ship across a whole catalog in an afternoon while the competition leaves it blank.

4 Methods to Bulk Add Alt Text in Shopify

There is no single best method. It depends on catalog size, who writes the text and whether you need to keep doing it for new products. Here is the honest comparison:

Method 1: Shopify Admin Without an App (One Image at a Time)

Shopify's add alt text guide gives one native route: open the product, click a media item to open its preview, click Add alt text, type, Save alt text. The same guide states the limit: "The maximum length is 512 characters, but 125 or less is recommended."

How to do it

1. Go to Products and open a product.
2. Click an image in the Media section to open the preview.
3. Click Add alt text (or Edit alt text if one exists).
4. Write the description, click Save alt text, close the preview, repeat for the next image.

What about the Bulk Editor?

Select products, click Bulk edit, open Columns: you will find tags, metafields, price, SKU, vendor, type and status. There is no image alt text column, so the grid cannot touch it. Older guides that say otherwise are describing an app that extends the grid. The same limitation applies to SEO titles and descriptions, covered in the bulk edit meta tags guide.

So the admin route is fine for ten hero images and your best-selling products. For the whole catalog you need the CSV, an app, or the API.

Method 2: CSV Export/Import (No App, You Write Every Line)

Shopify's product CSV guide includes an Image alt text column and says to use one row per image, with only the handle and image URL filled on the extra rows. A product can have up to 250 images, so a big catalog produces a long sheet.

Step-by-step

1. Go to Products → Export, choose All products and Plain CSV file. Keep this file untouched as your backup.
2. Open a copy in Google Sheets. Each image is its own row; Image Src and Image Position tell you which image a row is.
3. Write alt text in Image alt text for each row. A formula that joins the product title, the variant and the angle gives you a baseline to edit by hand.
4. Delete every column except Handle, Image Src, Image Position and Image alt text. Delete the rows you did not change.
5. Download as CSV, go to Products → Import, upload, tick Overwrite products with matching handles, and continue.

The two rules that save you

• Blank cells overwrite. Shopify's import rules say a present-but-empty column is written as blank, while a missing column leaves the value alone. Never import a column you have not filled.
• Never sort the sheet. Shopify's import guide warns that sorting can separate products from their image rows and lose the images. Filter instead.

The CSV route works for a one-off clean-up by a team comfortable with spreadsheets. The bottleneck is the writing: a formula gives you "Red cotton t-shirt, product photo", and a person still has to turn it into "Men's red organic cotton crew-neck t-shirt, front view on white".

Method 3: AI Alt Text Generation with MetaGenius AI

Quick disclosure: we make MetaGenius AI. We think it is the fastest way to give a Shopify catalog quality alt text. Here is how it works, and where it falls short.

How it works

MetaGenius AI reads each product's title, description, variant data and image, then writes a description per image. You review the output in the preview, edit what needs it, and save. Everything happens inside the Shopify admin, with no CSV and no external tool.

• Bulk generation: filter to products with missing alt text and generate in one run. The Free plan runs 10 items per batch so you can judge quality before paying; Starter removes the cap, and each image costs 1 credit.
• Autopilot (Pro): new products get alt text as they are created, so the gap never reopens.
• Custom instructions: tell it your vocabulary, what to include (material, colour, use) and what to skip (competitor names, prices).
• 15 languages: written in the market's language, not translated from English.

Where it falls short

AI alt text is good, not perfect. It can misread context, calling a gold-plated ring a gold ring, or describe a lifestyle shot by its background instead of the product. That is why every result is shown before it saves: you scan, fix the odd line, and publish. The AI vs manual alt text comparison shows the kinds of errors to look for.

Method 4: Shopify Admin API (Developer Route)

For stores with a developer on hand, the Admin GraphQL API gives full control over product media. The fileUpdate mutation takes a MediaImage id and an alt value; the older productUpdateMedia mutation does the same but is marked deprecated in favour of fileUpdate.

How it works

Query products and their media, filter to images whose alt is null or empty, build a description from the product title, variant and image position (or call a vision model), and send fileUpdate in batches. Log every change so you can roll back.

When it makes sense

• You need custom rules, such as different patterns for product-on-white shots and lifestyle shots.
• Alt text should be written inside your own product publishing pipeline, triggered when a product is created.
• The catalog is large enough that a maintained script pays for itself.

When it does not

A custom script costs developer time to build and to maintain every time the API version changes. For most stores, an app that already does the same job for free or $9.99 a month is the cheaper engineering decision.

What Good Product Alt Text Looks Like

Google's image guidance is short: describe the image in a way that is useful to someone who cannot see it, use keywords where they fit, and never stuff them. For product images that turns into a few consistent patterns.

The formula that works

[Product name] + [key variant details] + [context or angle]

• Good: "Women's navy merino wool crew-neck sweater, front view on white background"
• Good: "Handmade ceramic pour-over coffee dripper in matte black, close-up of filter holes"
• Bad: "sweater" (too vague; Google learns nothing)
• Bad: "best navy sweater for women buy now free shipping wool merino crew neck 2026" (keyword stuffing, which Google's image guidance says may be treated as spam)

More patterns by category are in best alt text examples for product images.

Rules that matter

• Skip "image of" and "photo of". Screen readers already announce it as an image.
• Include the brand or model name when it adds search value. "Yeti Rambler 26oz tumbler in Canopy Green" captures a branded query; "green tumbler" does not.
• Do not repeat the product title verbatim on every image. The H1 already carries it. Alt text adds what the title does not say: colour, angle, context.
• Pair it with a descriptive filename where you can. Google's guidance prefers short, descriptive filenames over IMG_4519.jpg.

The basics of adding and editing the field are in how to add alt text in Shopify; how it fits the rest of your SEO is in the complete Shopify SEO guide.

Shopify Image Alt Text Character Limit: 512 Max, 125 Recommended

Shopify's alt text guide sets the field limit at 512 characters and recommends 125 or fewer. Google does not truncate alt text at any specific length; the 125 target comes from how screen readers read long strings aloud, and from the fact that a good product description rarely needs more.

In practice most product images are well described in 60 to 125 characters. The exceptions are charts, infographics and images with text, where the text alternative has to carry the content and can run longer. The alt text character limit guide covers those cases with examples.

Edge Cases Most Guides Skip

Generic alt text advice covers the common case. These are the situations that trip up real stores.

Decorative images: use empty alt

If an image is purely decorative, a background pattern, a divider, a lifestyle banner with no identifiable product, use alt="". That tells screen readers to skip it. Descriptive text on a decorative image clutters the experience and sends Google a confusing signal.

WebAIM's alt text guide is the reference here. The rule: if removing the image would not change the information on the page, it is decorative.

Variant images: differentiate each one

A product with six colours and four angles each has 24 images, and each needs its own line. The common mistake is one description copied across all of them: "Blue cotton t-shirt" for every angle of every colour.

Specify the variant and the angle instead: "Men's blue organic cotton t-shirt, side view" and "Men's red organic cotton t-shirt, back view". This is where manual methods break first, and where AI generation pays for itself in the first hour.

Multi-language stores: alt text needs translating too

If you use Shopify Markets to serve several languages, alt text should match each market's language. English alt text on a German product page is a mixed signal for Googlebot and useless for a German screen reader user. MetaGenius AI writes alt text in 15 languages so each market reads naturally.

Images with embedded text

Size charts, infographics and promotional banners need alt text that carries the text in the image. alt="size chart" tells a screen reader user nothing. "Size chart showing bust, waist and hip measurements in inches for sizes XS through XXL" does the job and satisfies WCAG 2.2, which treats images of text as content that needs a text alternative.

The next step

Run the alt text checker on a product page to count the blanks, pick the method that matches the number, and start with the products that already get impressions in Search Console. Those are the images Google is already trying to show.