Set descriptive alt text for every meaningful product and theme image, keep each description concise, and use Shopify’s bulk editor, CSV import, or an API script once you’re past a handful of listings. Skip the field entirely and you lose accessible shopping experiences for screen reader users and miss out on image search traffic that costs nothing to capture. Do it manually one product at a time and it eats a Saturday you don’t have.
TL;DR:
- Adding descriptive alt text to every meaningful image is essential for accessibility and drives free image search traffic, especially as Shopify does not auto-fill these fields.
- Bulk editing options like Shopify’s bulk editor, CSV reimports, and API scripting help manage large catalogs efficiently but require careful backup and spot-checking.
- Descriptive alt text should follow the product name plus attributes formula, stay under 125 characters, and avoid keyword stuffing or starting with “image of.”
- Automation tools and AI drafts are useful for large catalogs, but all generated descriptions must be reviewed to prevent errors and inaccuracies.
- Decorative images should have empty alt attributes, and regular checks ensure coverage, specificity, appropriate length, and proper handling of non-informative graphics.
How do you add alt text in Shopify admin and the theme editor?
Shopify doesn’t fill in alt text automatically. The field sits empty until you type something into it, whether that’s on a single product photo or a background image baked into your theme, according to Shopify’s own Help Center guidance. Here’s the process for each case.
On desktop, for product images:
- Go to Products and open the listing you want to edit.
- Click on the image itself in the media gallery.
- Select Edit alt text from the menu that appears.
- Type your description and click Save.
For theme images (banners, collection headers, background graphics):
- Go to Online Store → Themes and click Customize.
- Click the image block you want to edit.
- Look for the Edit alt text or Image alt text field in the settings panel on the left.
- Save your changes and preview before publishing.
On the Shopify mobile app, the alt text field appears in the same image edit screen, though it’s sometimes tucked under a “more options” toggle. Tap the image, find the field, type, and confirm. Save immediately. Mobile sessions get interrupted.
Variant images need their own attention. Shopify doesn’t automatically inherit the parent product’s alt text down to each colour or size variant, so if you upload six colourways of the same jumper, each one needs its own line describing that specific variant, not a copy-pasted product name repeated six times.
What makes alt text actually work for accessibility and SEO?
A reliable formula: product name + visible attribute + view or context. That’s it. “Women’s merino wool jumper, forest green, folded flat lay” tells a screen reader user exactly what’s on screen and gives search engines something specific to index. Compare that with “IMG_4021.jpg” or “jumper,” which tells nobody anything useful.
Shopify caps the alt text field at 512 characters but recommends keeping it to roughly 125 characters or fewer, and that’s good practice regardless of the platform. Aim for 5 to 15 words. Anything longer starts reading like a product description crammed into the wrong box.
A few rules worth following on every image:
- Never start with “image of” or “picture of.” Screen readers already announce that it’s an image, so the phrase is dead weight, per MDN’s guidance on the img element.
- Use one natural keyword phrase per image at most. Stacking three or four keyword variants into a single alt tag reads as spam to both people and search engines.
- For decorative graphics that carry no meaning (a dividing line, a repeated pattern background), use an empty alt attribute,
alt="", rather than skipping it or filling it with filler text. The W3C’s WAI decision tree sets out exactly when an image counts as decorative versus meaningful. - Treat the description as something a sighted customer could picture from the words alone.
Examples across a typical product page: a hero shot might read “Men’s leather Chelsea boot, tan, side profile.” A close-up detail shot: “Stitching detail on tan leather Chelsea boot heel.” A lifestyle image: “Man walking in tan Chelsea boots on cobblestone street.” An infographic showing size measurements needs its data spelled out in the alt text or nearby text, not just implied by the image.
WebAIM’s large-scale review of homepage accessibility found that a substantial share of images across the web still carry missing or unhelpful alt text, and ecommerce catalogues are a common offender simply because of image volume.
How do you bulk edit alt text across an entire Shopify catalogue?
Editing image by image works fine for ten products. It falls apart at five hundred. Three routes handle scale.
- Shopify’s bulk editor. From Products, select multiple items, then use the bulk editor’s column view. Add the “Image alt text” column if it isn’t showing by default, and you can edit several products’ alt text in a spreadsheet-style grid without leaving the admin.
- CSV export and reimport. Export your product CSV, and you’ll get columns including image src and image alt text. Use a spreadsheet formula to auto-generate a baseline description, something like concatenating the product title column with the variant colour column, then hand-review before reimporting. One practical approach described by Craftshift’s Shopify alt text guide is building the formula as
=CONCATENATE(A2," in ",B2)to merge a product name cell with a variant cell. - Admin API scripting. For recurring imports or large product feeds, a script against Shopify’s Admin API can update alt text fields automatically as new products land, which suits stores adding dozens of SKUs weekly.
Pro Tip: Always keep a backup copy of your CSV before reimporting. Preserve the image ID and variant association columns exactly as exported. A single misaligned row can attach the wrong description to the wrong photo across your whole catalogue.
Spot-check a sample of products after any bulk update. Don’t assume the import worked cleanly just because Shopify didn’t throw an error.
Can you automate Shopify alt text with apps or AI?
Yes, and for catalogues running into the hundreds or thousands of images, some form of automation is close to essential. The category breaks down into a few types: dedicated alt-text generator apps, broader bulk-edit apps that include alt text among other fields, DAM or CMS integrations that carry metadata across platforms, and custom API scripts built for a specific catalogue structure.
The safest pattern looks like this: auto-generate a first-pass description for every image, route those drafts through a human review step, then publish. Skipping the review step is where automation goes wrong. AI models describing product photos commonly misjudge colour, invent background details that aren’t in the shot, or overstate claims a product doesn’t actually make. That last one carries real risk if a generated description implies a certification or material the product doesn’t have.
Before adopting any tool, run it through a short checklist:
- Test sample outputs against your actual product photos, not a demo catalogue.
- Confirm you can edit the generated text before it publishes, not just after.
- Check the app’s availability and support for your storefront’s region.
- Read the data policy: are your product images or catalogue data used to train external models?
- Confirm it writes directly back into Shopify’s alt text field rather than a separate metadata layer nobody sees.
Pro Tip: Run automated tools on your lowest-traffic products first. If something goes wrong, colour errors or invented scene details, you catch it before it touches your bestsellers. Broader thinking on vetting automation tools for Shopify stores is covered in this guide to Shopify SEO automation.
What mistakes should you avoid, and what’s the final checklist?
The same handful of errors show up across most Shopify catalogues. Leaving meaningful images with no alt text at all is the most common, closely followed by pasting the identical description across every image in a product gallery, so five photos of the same dress all say “blue dress” with nothing distinguishing the front view from the back. Keyword stuffing is another. Cramming “leather boots, men’s boots, tan boots, boots for men” into one field doesn’t help ranking and actively harms the screen reader experience. Starting with “image of” and uploading filenames like “DSC_00234.jpg” as the alt text round out the list.
Before publishing, run each product image through a short check:
- Product name is present and specific.
- Variant detail (colour, size, material) is included where relevant.
- Length sits under roughly 125 characters.
- Decorative images use an empty
alt=""rather than filler text.
| Check | What to look for |
|---|---|
| Coverage | Every meaningful image has non-empty alt text |
| Specificity | Variant and attribute named, not just product title |
| Length | Roughly 125 characters or fewer |
| Decorative images | Empty alt="", not skipped or filled with filler |
For sampling after a bulk edit, don’t check every product. Pull your top 20 to 30 SKUs by traffic or revenue first, since errors there cost you the most, then spot-check a random handful from the rest of the catalogue.
Accessibility isn’t a compliance box, it’s a conversion lever
The instinct is to treat alt text as a legal checkbox, something you fix once and forget. That undersells it. Descriptive alt text helps a sighted shopper too, because a well-written line acts as a second, faster read of what’s in the photo before the full description loads.
AI drafting tools speed up the first pass, but they need a human checking the output against the actual photo every time, not just the first ten. Build alt text assignment into your product upload process from day one rather than treating it as a cleanup job for later. Gaps compound fast across a growing catalogue, and following WCAG-aligned guidance reduces legal exposure as a side effect of doing the work properly anyway.
— Jamie Moss
Speed up the drafting without skipping the review step
Writing accurate alt text for a catalogue of hundreds of products is slow work when you’re doing it line by line, and some AI tools are designed to help with this. Rather than staring at a blank field for every image, such tools generate draft product and image descriptions from your existing catalogue data, giving you a consistent, template-driven starting point across every listing instead of a patchwork of half-finished fields.
You still verify each draft against the actual photo before it goes live, since no automated tool should skip that check, but you’re editing rather than writing from scratch. MerchUp AI’s visual editor integrates directly with Shopify, so approved drafts publish back into your catalogue without a separate export step. If you want to see the drafting workflow in action, the MerchUp tutorial walks through generating content in under a minute, and the MerchUp product page covers the full feature set for stores managing larger catalogues.
Sources
Shopify’s Help Center and blog guide cover procedure; the W3C’s WAI sets accessibility standards.
- W3C Web Accessibility Initiative — images decision tree
- US Department of Justice — web accessibility resources
- WebAIM million‑page accessibility study
FAQ
What is an example of good Shopify alt text?
“Women’s merino wool jumper, forest green, folded flat lay” is a solid example: it names the product, the attribute, and the context in under 15 words, following the formula recommended in Shopify’s own guidance.
Is alt text legally required for Shopify stores?
There’s no single US law that names “Shopify” or “alt text” specifically, but ADA and web accessibility guidance treats text alternatives for images as a core expectation for digital storefronts, and following WCAG standards reduces legal risk.
How do I add alt text in Shopify?
Open the product in Products, click the image, select Edit alt text, type your description, and save. Theme images follow the same pattern through Online Store → Themes → Customize.
Is alt text good for Shopify SEO?
Yes. Search engines can’t see an image directly, so descriptive alt text gives them text to index for image search results, and Shopify’s own guidance treats it as a standard part of on-page optimisation alongside titles and meta descriptions.
Do I need alt text on every single product image?
Every meaningful image needs it, but purely decorative graphics, like a background pattern with no informational content, should use an empty alt="" attribute instead, per the W3C’s decision tree.
Comments
No comments yet — be the first to share what you think.