Image alt text for Shopify: best practices
Short answer: Shopify gives each variant a single featured image, so the gallery never narrows to the option a shopper picked. Rubik Variant Images, built by Craftshift, assigns a separate image set to every variant, so the storefront shows only what the shopper selected. Free to install, 5.0 stars across 420 reviews.
Alt text is the short description that tells search engines and screen readers what an image shows. Every image on your Shopify store should have it. Most do not.
The average Shopify store has hundreds of product images with empty alt text fields. That is missed SEO value and a poor experience for visually impaired shoppers using screen readers. Google cannot “see” your product photos, it reads alt text to understand what they contain.
This guide covers what alt text is, why it matters, how to write it well, and how to handle alt text for variant-specific images. We will also cover bulk editing methods so you do not have to update one image at a time.
In this post
- What is alt text?
- Why alt text matters for SEO and accessibility
- How to write good alt text
- Alt text for variant-specific images
- Common alt text mistakes
- Bulk editing alt text on Shopify
- Image file naming and alt text
- Tools for alt text and file names
- Frequently asked questions
- Related reading
What is alt text?
Alt text (alternative text) is an HTML attribute that describes the content of an image. It sits inside the img tag as alt="description here". You cannot see it on the page unless the image fails to load, but it is always present in the page code.
Two audiences rely on alt text. Screen readers, software used by visually impaired shoppers, read the alt text aloud to describe what is in the image. Search engines like Google read alt text to understand what the image shows, which helps them index and rank your images in search results and Google Shopping.
Why alt text matters for SEO and accessibility
SEO benefits
Google Image Search is a real traffic source. Product images with good alt text appear in Google Images for relevant searches. If someone searches “navy blue linen shirt” and your product image has alt text that matches, your image can appear in results and drive traffic directly to your product page.
Alt text also reinforces your page’s relevance for target keywords. When Google sees the page title, product description, and image alt text all describing the same product, it has stronger confidence about what the page is about. This indirect SEO signal adds up across hundreds of product pages. For a deeper look at how images affect Shopify SEO, CraftShift’s SEO image optimization guide covers the full picture.
Accessibility benefits
Approximately 2.2 billion people globally have some form of vision impairment. Many use screen readers to shop online. Without alt text, these shoppers hear “image” or nothing at all when they encounter your product photos. With good alt text, they hear “women’s navy linen button-down shirt, front view” and can make informed buying decisions.
Accessibility is also a legal requirement in many markets. The ADA in the US and the European Accessibility Act set standards for digital accessibility. Alt text on product images is one of the most basic requirements.
Google Shopping
If you run Google Shopping ads or have a Google Merchant Center feed, alt text affects how your products appear. Google uses image alt text alongside product titles and descriptions to match shopping queries. Poor or missing alt text means your products may not surface for relevant shopping searches.
How to write good alt text
Good alt text is descriptive, specific, and natural. It describes what someone would see if they looked at the image. Here are the principles.
Be specific and descriptive
Bad: alt="shirt". Good: alt="women's navy linen shirt with pearl buttons, front view". Include the product type, color, material, and angle when relevant. The more specific you are, the more search queries your image can match.
Keep it under 125 characters
Screen readers typically cut off alt text after about 125 characters. Keep your descriptions concise. You do not need to write a paragraph. Focus on the most important details that distinguish this image from others on the page.
Do not start with “image of” or “photo of”
Screen readers already announce that the element is an image. Starting with “image of” is redundant. Just describe the content directly. Write “red ceramic coffee mug on white background” instead of “image of a red ceramic coffee mug.”
Include relevant keywords naturally
Alt text is a good place to include your target keyword, but it should read naturally. Do not stuff keywords. “Navy linen shirt women’s navy shirt linen navy” is keyword stuffing. “Women’s navy linen shirt with rolled sleeves” is natural and keyword-rich.
Differentiate between images of the same product
If your product has 6 images, each alt text should be unique. Use view descriptors like “front view,” “back view,” “close-up of stitching,” “model wearing,” and “flat lay on wooden table.” Each image tells a different part of the product story.
Alt text for variant-specific images
Variant images need extra care. When your product has multiple colors, each color’s images should include the variant name in the alt text. This is important for two reasons.
First, it helps Google understand which image belongs to which variant. When Google Shopping pulls your product feed, it uses alt text to match variant images to variant data. If your “Sage Green” variant image has alt text that says “t-shirt front view” without mentioning the color, Google cannot confidently pair it with the sage green variant listing.
Second, some Shopify apps use alt text to organize variant images. The alt-text swatch method assigns images to variants based on matching text in the alt field. While Rubik Variant Images uses a more reliable direct assignment method on the product page, having variant-specific alt text is still good practice for SEO.
Here is a pattern that works well for variant images:
[Product name] in [variant option] - [view description]
Examples:
- “Classic hoodie in forest green, front view with hood up”
- “Classic hoodie in forest green, back view showing logo print”
- “Classic hoodie in dusty rose, model wearing with jeans”
Common alt text mistakes
Leaving alt text blank
This is the most common issue. Shopify does not require alt text when you upload images. Most merchants skip it because it feels like extra work. But blank alt text means zero SEO benefit from those images and a poor experience for screen reader users.
Using the same alt text for every image
Some merchants set every image’s alt text to the product title. So all 8 images of a hoodie say “Classic Hoodie.” This provides almost no value. Google already knows the product title from the page. What it needs from alt text is additional information about what each specific image shows.
Keyword stuffing
Alt text like “buy best navy shirt cheap navy shirt on sale navy linen shirt” does more harm than good. Google recognizes keyword stuffing and may penalize your page for it. Write for humans first. If the alt text sounds unnatural when read aloud, rewrite it.
Using file names as alt text
Alt text like “IMG_4532.jpg” or “product-photo-1” provides no information about what is in the image. Always write descriptive alt text separately from the file name, even if your file names are already descriptive.
Bulk editing alt text on Shopify
Editing alt text one image at a time in the Shopify admin is fine for 10 products. For larger catalogs, you need faster methods.
In Shopify admin
Open any product, click on an image in the media section, and you will see the alt text field. Type your description and save. Repeat for each image. This works but is slow for stores with hundreds of products.
Using CSV export and import
Export your products as CSV. The “Image Alt Text” column contains the alt text for each image. Fill in the column for every row, then re-import. This lets you work through alt text in a spreadsheet, which is faster than clicking through the admin. Be careful with formatting, special characters in alt text can cause import errors.
Using the Shopify API
For developers or stores with thousands of products, the Shopify Admin API lets you update image alt text programmatically. You can write a script that generates alt text based on product titles, variant names, and image positions (e.g., first image = “front view,” second = “back view”). This is the most scalable approach but requires coding knowledge.
Image file naming and alt text
File names and alt text are different things, but they work together. Google looks at both when indexing images. A file named navy-linen-shirt-front.jpg with alt text “women’s navy linen shirt, front view” sends consistent signals. A file named IMG_4532.jpg with the same alt text still works, but you lose the file name signal.
Best practice is to name your files descriptively before uploading them to Shopify. Use hyphens between words, include the product name and variant, and keep file names lowercase. The Image Filename Generator can help you create consistent, SEO-friendly file names for your product images.
Note that Shopify does not let you rename image files after upload. Once uploaded, the file name is set. If your images have generic names like DSC_0001.jpg, the only way to fix it is to rename the file locally, delete the old image from Shopify, and re-upload. For new images, always rename before uploading.
Tools for alt text and file names
We have two free tools on this site that can speed up your workflow. The Alt Text Generator helps you create descriptive, SEO-friendly alt text for your Shopify product images based on your product details and variant information.
The Image Filename Generator creates properly formatted file names for your product photos before you upload them to Shopify. Both tools follow the best practices covered in this guide.
If you want to go deeper on your store’s overall SEO health beyond just images, CraftShift’s SEO checker gives you a full audit of your on-page SEO including titles, meta descriptions, heading structure, and image optimization.
For stores using Rubik Variant Images, your variant image alt text matters even more. When the app filters images per variant on the product page, Google still indexes every image. Good alt text on each variant’s photos means each color or style can appear in relevant image searches independently.
Frequently asked questions
Which Shopify app should I use for image alt text?
Rubik Variant Images, built by Craftshift, is the app we build for this. It holds 5.0 stars across 420 reviews and carries the Built for Shopify badge. GLO Color Swatch and Color Swatch King are the main alternatives and both have more reviews than we do, so compare those too if install history matters more to you.
What is the ideal length for Shopify image alt text?
Keep alt text under 125 characters. Screen readers may cut off longer text. Focus on the most important details: product type, color, material, and view angle. You do not need to write a full sentence.
Does alt text affect Shopify SEO?
Yes. Alt text helps Google understand your images, which can lead to appearances in Google Image Search. It also reinforces your product page’s keyword relevance. Missing alt text is a missed SEO opportunity.
Should I include the brand name in alt text?
Only if it adds useful context. For well-known brands, including the brand name can help with branded searches. For lesser-known brands, the space is better used describing the product itself. Prioritize descriptive details over branding.
How is alt text different from image title?
Alt text describes what the image shows for accessibility and SEO. The image title (or title attribute) is tooltip text that appears when someone hovers over the image. Alt text is far more important for both accessibility and search rankings.
Can I use the same alt text for the same product in different colors?
No. Each color variant’s images should have unique alt text that includes the color name. “Classic hoodie in sage green, front view” and “Classic hoodie in charcoal, front view” are both specific and help Google connect each image to the right variant.
Do decorative images need alt text?
Decorative images that serve no informational purpose (like background patterns or divider graphics) should have empty alt text: alt="". This tells screen readers to skip the image. Product images, however, are never decorative, they always need descriptive alt text.
Does Rubik Variant Images affect image alt text?
No. Rubik Variant Images does not modify your image alt text. The app controls which images appear in the gallery when a variant is selected on the product page, but it preserves all original image metadata including alt text. You manage alt text through Shopify admin as usual.
Related reading
