L · LEGIBLE

How to audit missing Shopify product alt text

Check product image descriptions, distinguish missing text from weak text, and keep an honest record of your audit scope.

Define what you are checking

Start with product media. Images in collection banners, blog posts, product descriptions and theme sections require separate inspection. Record which products and views you checked and the date; a page of results is not a complete store audit.

Inspect every product view

Open Products in Shopify, choose a product, and open each media item. Read the alt-text field. Check later gallery images as well as the primary image. For larger catalogs, Shopify also supports alt-text CSV imports; export a copy before a bulk cleanup.

Separate presence from quality

An empty field is a gap to investigate. A filename or repeated product title is present text that may still need improvement. Compare each description with the image and its purpose on the page. Decorative images can appropriately have empty alt text, so missing text alone is not proof of an accessibility failure.

Keep the result honest

Legible shows missing, with-alt and scanned counts for the loaded product page. Move through product pages to inspect more images. Use the Flagged filter to find common writing issues, and export the current view as a review worksheet. The checker cannot assess visual accuracy or certify your store.

Try the writing check

Check a description in your browser. Text stays on your device; no image is uploaded or analyzed.

Try Legible on your Shopify product images. Start with 25 credits per calendar month, then review drafts before approving.

References and further reading

Shopify’s alt-text instructions and limits · W3C’s image alt decision tree