How to fix image alt on BigCommerce

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

Steps for BigCommerce

  1. Product images: Admin → Catalog → Products → [Product name] → Images & Videos tab → hover over an image thumbnail and click the pencil/edit icon → fill in the 'Alt Text' field → Save.
  2. Banner images (via Marketing → Banners): alt text for banners is set in the HTML source — click the HTML editor icon in the banner editor and add alt="..." to the <img> tag.
  3. Theme images: Storefront → Themes → Advanced → Edit Theme Files → locate the relevant template (.html) and add or correct the alt attribute on <img> tags.
  4. Page Builder widgets: When adding an image widget in the Page Builder (Storefront → My Themes → Customize), look for an 'Alt Text' field in the widget's right-hand panel.
Official BigCommerce 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 BigCommerce 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