How to fix listitem on WooCommerce

Ensure every `<li>` element is a direct child of a `<ul>` or `<ol>` element (or an element explicitly given `role="list"`), so that screen readers can correctly announce list structure to users.

Steps for WooCommerce

  1. Open your WordPress admin → Appearance → Theme File Editor (or use a local/FTP editor for a safer edit).
  2. Identify which template file renders the broken list — common files are `header.php`, `footer.php`, `functions.php`, page templates, or a plugin shortcode output. Use your browser's View Source / DevTools to trace the HTML to its template.
  3. Find the `<li>` element and confirm its direct parent is not `<ul>` or `<ol>`. Wrap the `<li>` elements in the appropriate container: `<ul>` or `<ol>`.
  4. If the issue is inside a plugin (e.g. a WooCommerce widget, product tabs plugin, or mega-menu plugin), first try the plugin's own settings for 'list markup' or 'HTML output'. If unavailable, use a child-theme template override: copy the plugin's template file into your child theme's directory and edit it there.
  5. Clear any caching plugin cache (e.g. WP Super Cache, W3 Total Cache, LiteSpeed Cache) after saving.
  6. Re-check with the axe DevTools browser extension to confirm the violation is resolved.
Official WooCommerce documentation ↗

What is listitem?

HTML lists are built from two parts: a container (`<ul>` for unordered, `<ol>` for ordered) and its items (`<li>`). When a `<li>` element's parent is something other than `<ul>`, `<ol>`, or an element with `role="list"`, the list structure is broken. This means a screen reader — the software blind and low-vision shoppers use to navigate — cannot tell the user they are inside a list, how many items it contains, or let them jump between items efficiently. The WCAG success criterion 1.3.1 (Info and Relationships) requires that structure conveyed visually (like a list of product features or navigation links) also be conveyed in the underlying code.

Screen reader users rely on correct list markup to understand and navigate your page — if list items are orphaned from their parent container, assistive technology may read each item as isolated, unrelated text, destroying the meaning of product feature lists, navigation menus, breadcrumbs, and shopping cart line items. This is a WCAG 2.x Level A failure (the most severe category), which creates legal accessibility risk under laws like the ADA in the US, the EAA in Europe, and equivalent legislation worldwide — online retailers have faced lawsuits and regulatory action over exactly these kinds of structural failures. Beyond legal risk, poor accessibility can reduce conversions from the roughly 1-in-4 adults who have a disability, and Google's crawlers also use semantic structure to understand page content, so clean markup supports SEO as a secondary benefit.

See the complete Listitem guide for every platform and the full background.

Not sure if your WooCommerce store has this?

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

Scan my site free

Fix listitem on another platform