Blog › Accessibility › How Do You Write Alt Text for Product Images?
Noibu blog

How Do You Write Alt Text for Product Images?

How do you write alt text for product images?

Write alt text for product images by describing what a shopper needs from each image: the product name plus the detail that photo adds, such as color, angle, material or fit. Keep it short and specific, leave out phrases like image of, use empty alt for decorative images, and name the destination when an image is a link.

Last updated November 17, 2026

Alt text is the short text alternative that screen readers announce in place of an image, and that browsers show when an image fails to load. On a product page, images carry most of the information a shopper uses to decide, so weak or missing alt text leaves screen reader users guessing about color, style and condition. This playbook covers the rule behind alt text, a five-question method for each image, good and bad examples for every common product image type, and how to write alt text across a whole catalog.

Key takeaways

  • WCAG 2.1 success criterion 1.1.1 asks for a text alternative that serves the same purpose as the image, not a literal description of every pixel.
  • Each product image needs alt text that says what that specific image adds: the view, color, detail or context.
  • Decorative images get an empty alt attribute, and linked images describe where the link goes.
  • At catalog scale, build alt text from product attributes, then review it by hand. Never use file names or keyword lists.

Part of: Noibu's ADA Agent

What does WCAG require for product image alt text?

The rule is WCAG 2.1 success criterion 1.1.1, Non-text Content, a Level A requirement. It says all non-text content presented to the user has a text alternative that serves the equivalent purpose. The W3C Understanding document adds two exceptions that matter on product pages: images that are controls need a name that describes their purpose, and images that are pure decoration should be implemented so assistive technology can ignore them.

The key phrase is equivalent purpose. Alt text for a product image is not a caption and not an SEO field. It answers one question: what would a shopper who cannot see this image need to know to get the same value from it? For a hero product photo, that is what the product is and what it looks like. For a close-up of a zipper, it is the zipper.

Missing alt text is still one of the most common accessibility failures on the web. In the WebAIM Million 2026 report, which tests the home pages of the top one million websites, missing alternative text was found on 53.1% of home pages, the second most common failure after low-contrast text. The same report found that 45% of images missing alt text were linked images, which leaves links that do not say where they go. Store-wide checks are covered in the WCAG 2.1 AA checklist for online stores.

How do you decide what alt text a product image needs?

The W3C Web Accessibility Initiative publishes an alt decision tree that works well for product pages. It asks a short series of questions in order, and the first question that applies decides the alt text. The step flow below adapts it to the images a typical store uses.

Five questions to ask about every product image

  1. 1

    Does it contain text?

    If the text in the image appears nowhere else, such as a sale badge, put that text in the alt.

  2. 2

    Is it a link or button?

    Describe the destination or action, such as the product the card opens or the color a swatch selects.

  3. 3

    Does it add meaning?

    Briefly describe what this image shows that the others do not: the angle, color, detail or setting.

  4. 4

    Does nearby text say it already?

    If real text next to the image carries the same information, use an empty alt to avoid repetition.

  5. 5

    Is it purely decorative?

    Backgrounds, dividers and flourishes get an empty alt attribute so screen readers skip them.

What does good alt text look like for each type of product image?

Product pages mix several kinds of images, and each kind follows a different rule. The table below shows a weak and a stronger version for the image types most stores use, with the reason for each. The examples use a fictional trail running shoe so the patterns are easy to compare.

Good vs bad alt text for product images
Image typeBadBetterWhy
Main product photoIMG_4821.jpg, or shoeRidgeline trail running shoe in slate gray, side viewNames the product, the color shown and the angle. A file name tells a shopper nothing.
Color or variant swatchswatch, or no alt at allSlate gray (or an empty alt if the swatch control already has a visible or programmatic label naming the color)A swatch is a control, so it needs a name that says what it selects. The selected state belongs on the control, not in the alt.
Lifestyle imagetrail shoes running shoes best trail running shoes menRunner wearing the Ridgeline shoes on a rocky mountain trailDescribes the use and setting the photo adds. A keyword list is noise to a screen reader user.
Zoom or gallery imageThe same product name on all six gallery imagesClose-up of the lugged rubber outsole; Heel pull tab, back viewEach gallery image shows something different, so each alt says what is different. The zoom button needs its own name, such as Zoom image 2 of 6.
Decorative imagedecorative purple swirl backgroundalt="" (empty alt attribute, not a missing one)An empty alt tells screen readers to skip the image. A missing alt often makes them read the file name.
Image with text, such as a sale badgered badgeSale: 30% off (or an empty alt if the same offer already appears as real text next to the price)Text inside an image is invisible to a screen reader unless the alt repeats it word for word.
Linked image, such as a product cardproduct image, or click hereRidgeline trail running shoe, slate gray (or an empty alt when the product name is link text inside the same link)When the image is the only content of a link, its alt is the link's name, so it must say where the link goes.

The linked image pattern comes straight from the W3C functional images tutorial. When an image is the only thing inside a link, its text alternative should describe the destination. When visible link text next to the image already names the destination inside the same link, the tutorial uses an empty alt so the screen reader does not announce the product name twice.

How do you write alt text for color and variant images?

Variant images cause the most confusion because the same product appears in several colors. Write alt text for each variant image that names the color shown, so a shopper who switches from slate gray to forest green hears the change. When a theme swaps the main image after a variant is selected, check that the alt text changes with it. A main image that still says slate gray after the shopper picks green gives wrong information, which is worse than a generic description.

Swatches themselves are controls. A screen reader user needs to hear the color name and whether it is selected. If the swatch image sits inside a labeled radio button or button that already announces the color, the image can take an empty alt. If the image is the only thing naming the control, the alt must carry the color name.

How long should alt text for product images be?

Short is better, but completeness wins over a character limit. Most product images need one sentence or a phrase of five to fifteen words. The Shopify Help Center notes that its alt text field accepts up to 512 characters and recommends 125 or fewer. If an image needs much more than that, such as a size chart or a care label, put the information in real text on the page and keep the alt brief.

Leave out image of, picture of and photo of. Screen readers already announce that the element is an image, so the phrase only adds delay. Also leave out information the shopper hears elsewhere on the page, such as the price, unless the image itself is the only place it appears.

How do you write alt text for product images at scale?

Stores with thousands of SKUs cannot write every alt by hand, but they can build a good first draft from product data. A practical template is product name, then the variant attribute shown, then the view or detail. For example, product name plus color plus side view gives Ridgeline trail running shoe in slate gray, side view. Store the view or detail as image-level data when uploading photos, so the template has something specific to use for the second, third and fourth gallery images.

Three rules keep templated alt text useful:

  • No file names. IMG_4821.jpg or ridgeline-gray-02-final.jpg means nothing to a shopper. The WebAIM Million report flags file names and generic values such as image or graphic as questionable alt text.
  • No keyword stuffing. Repeating search terms in alt text makes the page harder to use and does not describe the image. Write for the shopper, and the description will naturally include the product name.
  • No identical alt on every gallery image. If six images share one alt, five of them tell the shopper nothing new. Add the view or detail to each.

AI-generated alt text suggestions can speed up a backlog, and Shopify's media editor offers suggested alt text for images that have none. Treat any suggestion as a draft: check that it names the right product, the right color and nothing that is not in the photo. Then plan a review pass on the highest-traffic product pages first, as covered in which accessibility issues an online store should fix first.

Where do you set alt text in Shopify and BigCommerce?

In Shopify, alt text lives on each media item. According to the Shopify Help Center, go to Products in the Shopify admin, open the product, click the media item to open Preview media, click Add alt text, enter the text and click Save alt text. Shopify also supports uploading alt text in a CSV file for bulk changes. Theme images such as banners and collection images are set separately in the theme editor. A Shopify-specific walkthrough for finding image and other accessibility issues is in how to find accessibility issues on a Shopify store.

In BigCommerce, each product image carries its own alt text value. The BigCommerce developer documentation on product images shows that the altText field can hold a global value for the store and an override per channel locale, which matters for stores selling in several languages. Teams with large catalogs can set it through the GraphQL Admin API rather than one product at a time.

How do you check alt text after you write it?

Automated tools reliably catch images with no alt attribute and linked images with no accessible name. They cannot judge whether alt text is accurate, so a manual pass still matters. Turn on a screen reader such as VoiceOver or NVDA, open a top product page and move through the gallery, swatches and recommendations. Listen for file names, repeated text, wrong colors and links that do not say where they go.

Alt text also drifts. New products, new themes and app installs add images with missing or default alt, so a one-time pass does not stay accurate for long. A schedule for re-checking after releases is covered in what accessibility monitoring is and why a one-time audit is not enough.

How does Noibu's ADA agent help with product image alt text?

Noibu's ADA agent audits a store's highest-traffic pages against WCAG standards, page by page and across templates rather than only the homepage. Missing alt text is one of the issue types it finds, alongside missing labels, low contrast and keyboard traps. It maps each issue to its element and the guideline it relates to, and ranks issues by the pages and traffic they affect, so a product image missing alt on a best-selling product page outranks one on an archive page.

For each issue, the ADA agent drafts a change and stages it for review. A person approves it before anything reaches the live store, and after a change is pushed live the agent re-audits the page to confirm the issue is resolved. It runs the same loop as every Noibu agent: find, build, your approval, ship, measure and compound. Teams work with it in the Noibu console or from AI tools like Claude through Noibu MCP. More detail is in Noibu's ADA Agent.

The ADA agent is one of six supervised Noibu agents, alongside Bug Resolution, Performance, CRO, A/B Testing and ROAS.

The short version

Good alt text for product images says what each image adds for the shopper: the product, the color or variant shown, and the view or detail. Decorative images get an empty alt, linked images name their destination, and text inside images is repeated in the alt. Build a first draft from product attributes, review it by ear, and re-check after every catalog or theme change. To see where a store stands today, start with Noibu's free website audit.

Noibu is AI for ecommerce operations, the always-on optimization system that keeps online stores running at their best. A team of supervised AI agents finds what's broken, slow, or leaking revenue, does the work, and hands results back for human approval. Trusted by retailers like Free People, Guess, Liquid I.V., and Ariat.

Frequently asked questions

What is alt text for product images?

Alt text is a short text alternative added to a product image so screen readers can announce what the image shows. It also appears if the image fails to load. Good product image alt text names the product and the detail that image adds, such as color, angle or setting.

Do decorative images on a product page need alt text?

Decorative images, such as background textures and dividers, should have an empty alt attribute so screen readers skip them. An empty alt is different from a missing alt, which can cause a screen reader to read out the file name.

Should every gallery image have the same alt text?

No. Each gallery image usually shows a different angle or detail, so each one needs alt text that says what is different, such as a close-up of the outsole or a back view. Identical alt text on every image tells the shopper nothing new.

How long should product image alt text be?

Most product images need a phrase or one sentence of about five to fifteen words. Shopify accepts up to 512 characters and recommends 125 or fewer. Longer information, such as a size chart, belongs in real text on the page.

Should I put keywords in product image alt text?

Write for the shopper, not for search. A clear description will naturally include the product name. Repeating search terms makes the alt text harder to listen to and does not describe the image.

Can I use AI to write alt text for product images?

AI suggestions can speed up a large backlog, but treat them as drafts. Check that each one names the right product and color and does not describe anything that is not in the photo, starting with the highest-traffic product pages.

How does Noibu's ADA agent handle missing alt text?

Noibu's ADA agent audits a store's highest-traffic pages against WCAG standards and finds issues such as missing alt text. It ranks them by the traffic they affect, drafts changes for review, and re-audits pages after approved changes go live.

Back to all blogs
‍
‍
See what Noibu’s AI agents would change on your store first.
Free website audit
Share

Keep your store running at its best, with AI agents that never clock out.