How to fix image alt on WooCommerce

Add descriptive alt text to every meaningful image, and mark purely decorative images with an empty alt attribute or role="presentation".

Steps for WooCommerce

  1. Product images: Admin → Products → [Product name] → click the featured image or any gallery image → in the Media Library modal, fill in the 'Alt Text' field on the right side → click 'Update'.
  2. For all images in the Media Library: Admin → Media → Library → click any image → fill in the 'Alternative Text' field in the Attachment Details panel.
  3. Theme/banner images: If using a page builder (Elementor, Divi, etc.), click the image widget → find the 'Alt Text' or 'Image Alt' field in the widget settings.
  4. For bulk alt-text updates consider the 'SEO Optimized Images' or 'Bulk Auto Alt Text' plugins available from the WordPress plugin directory.
  5. Use the Yoast SEO or Rank Math plugin — they flag images missing alt text during their content analysis and link directly to the edit screen.
Official WooCommerce documentation ↗

What is image alt?

Every `<img>` element on a web page should carry an `alt` attribute that describes what the image shows or does. This text is read aloud by screen readers for visitors who are blind or have low vision, and it appears in place of the image when it fails to load. Meaningful images (products, banners, infographics) need a short, accurate description. Purely decorative images (background shapes, dividers, icons used only for visual flair) should have an empty `alt=""` or `role="presentation"` so screen readers skip them entirely. WCAG Success Criterion 1.1.1 "Non-text Content" requires this for all conformance levels (A, AA, AAA).

Missing alt text directly harms your store in three ways. First, it excludes customers who rely on screen readers — they cannot understand what your products look like, which damages conversions and exposes you to legal risk under accessibility laws (ADA Title III in the US, EAA in Europe, AODA in Canada). Second, search engines like Google read alt text to understand and index your images; missing alt text means your product and category images are invisible to image search, costing you free organic traffic. Third, automated accessibility audits flag missing alt text as a critical failure, and regulators, plaintiff attorneys, and audit tools surface it prominently — making it one of the highest-priority issues to address on any ecommerce site.

See the complete Image alt guide for every platform and the full background.

Not sure if your WooCommerce store has this?

Run a free SEOLZ scan — we’ll find image alt and every other issue across your whole site.

Scan my site free

Fix image alt on another platform