Image without an alt attribute
WCAG 2.2 1.1.1 Non-text content, Level A
11 occurrences, found on: Home page, Product page
- Why it matters for shoppers
- A screen reader skips the image or reads out its file name, so a blind shopper does not learn what the product photo shows.
- Where it usually lives in a Shopify theme
- Product card and product media snippets, image banners, slideshow and image-with-text sections, and sometimes the logo in the header.
- Direction for a fix
- Output the alt text stored with the image, fall back to the product or section title, and give purely decorative images an empty alt="".
- Examples from the demo store
img.running-content-image__imgimg
Link without a name
WCAG 2.2 2.4.4 Link purpose (in context), Level A
9 occurrences, found on: Home page, Collection page, Product page, Cart page
- Why it matters for shoppers
- A screen reader announces “link” and nothing else, so the shopper cannot tell where it leads.
- Where it usually lives in a Shopify theme
- Icon links in the header (account, cart), social media icons in the footer, image-only links on product cards and collection tiles.
- Direction for a fix
- Add visually hidden text or an aria-label to icon links, for example “Cart” or “Instagram”. For an image link, give the image an alt text.
- Examples from the demo store
Dropdown without a label
WCAG 2.2 1.3.1 Info and relationships, Level A
4 occurrences, found on: Home page, Collection page, Product page, Cart page
- Why it matters for shoppers
- A shopper who cannot see the page does not know whether the dropdown chooses a size, a colour, a sort order or a country.
- Where it usually lives in a Shopify theme
- Variant pickers on the product page, the sort menu on collections, country and language selectors.
- Direction for a fix
- Name each dropdown with a label element (for and id) or an aria-label such as “Size” or “Sort by”.
- Examples from the demo store
select.js-predictive-search-product-type
Button without a name
WCAG 2.2 4.1.2 Name, role, value, Level A
2 occurrences, found on: Collection page
- Why it matters for shoppers
- The shopper hears “button” with no hint whether it closes a drawer, adds to cart or opens the menu.
- Where it usually lives in a Shopify theme
- Icon-only buttons: drawer close, slider arrows, quantity plus and minus, menu and search toggles.
- Direction for a fix
- Put an aria-label or visually hidden text on the button and hide the icon inside it with aria-hidden="true".
- Examples from the demo store
The same id is used more than once
WCAG 2.2 4.1.2 Name, role, value, Level A
34 occurrences, found on: Home page, Collection page, Product page
- Why it matters for shoppers
- Labels, error messages and aria references can point at the wrong element, so a field or control may lose its name.
- Where it usually lives in a Shopify theme
- Sections rendered twice on one page, such as desktop and mobile headers, cart drawer and cart page, or country and language selectors in both header and footer.
- Direction for a fix
- Make generated ids unique, for example by adding the section id to them.
- Examples from the demo store
"productQuickViewForm-template--22967009804592__product_lists_nKyC7H-8510035919152", 2×"productQuickViewForm-template--22967009804592__product_lists_nKyC7H-8510035427632", 2×"productQuickViewForm-template--22967009804592__product_lists_nKyC7H-8510035198256", 2×
Alt text is a file name or a placeholder word
WCAG 2.2 1.1.1 Non-text content, Level A
19 occurrences, found on: Home page, Collection page, Product page, Cart page
- Why it matters for shoppers
- Hearing “IMG_2841.jpg” or “image” tells a screen reader user nothing about the product.
- Where it usually lives in a Shopify theme
- Mostly content: alt text entered in the Shopify admin for product media and section images. Some themes fall back to the file name when the alt text is empty.
- Direction for a fix
- Describe the image in the admin, and in the theme fall back to the product or section title instead of the file name.
- Examples from the demo store
img.h-100img.media-mbimg.js-image-lazy
aria-labelledby or aria-describedby points to a missing element
WCAG 2.2 4.1.2 Name, role, value, Level A
10 occurrences, found on: Home page, Collection page, Product page, Cart page
- Why it matters for shoppers
- The element was meant to take its name or description from another element that is not on the page, so the screen reader has nothing to read.
- Where it usually lives in a Shopify theme
- Product cards that point at sale or sold-out badges which are only rendered in some cases, form error messages, dialogs.
- Direction for a fix
- Output the reference only when the target element is rendered, or always render the target.
- Examples from the demo store
aria-labelledby → "sectionHeading-0aeee28410c0"aria-labelledby → "sectionHeading-fcb23f9ad06d"aria-labelledby → "sectionHeading-02e09aebf718"
Empty heading
WCAG 2.2 1.3.1 Info and relationships, Level A
4 occurrences, found on: Home page, Collection page, Product page, Cart page
- Why it matters for shoppers
- A screen reader announces a heading with nothing in it.
- Where it usually lives in a Shopify theme
- Heading blocks left blank in the theme editor, or heading tags that wrap only an icon.
- Direction for a fix
- Do not output the heading tag when its setting is empty.
- Examples from the demo store
Icon without a text alternative or a decorative mark
WCAG 2.2 1.1.1 Non-text content, Level A
6 occurrences, found on: Product page
- Why it matters for shoppers
- If the icon carries meaning, such as a payment method or “free shipping”, a screen reader user misses it. If it is decoration, it should be hidden from screen readers.
- Where it usually lives in a Shopify theme
- Icon snippets, payment icons in the footer, trust and feature icons.
- Direction for a fix
- Hide decorative icons with aria-hidden="true". Give meaningful icons role="img" and an aria-label or a title element.
- What the test can see
- The test cannot tell a decorative icon from a meaningful one, so each of these needs a quick look.
- Examples from the demo store