How to fix definition list on Squarespace
Ensure every `<dl>` (definition list) element contains only properly nested `<dt>` and `<dd>` children, with no stray text, divs, or other elements placed directly inside it.
Steps for Squarespace
- Squarespace does not expose raw HTML for most blocks. If the malformed `<dl>` is inside a Code Block, go to the page in the Editor, click the Code Block, and edit the HTML directly.
- If the `<dl>` is generated by a Squarespace built-in block (e.g. a product page), you cannot edit it directly — inject corrective CSS or report it to Squarespace Support.
- For custom injected code, go to Settings → Advanced → Code Injection and locate any `<dl>` markup in the header/footer injection fields; correct it there.
- Publish and verify with the axe DevTools browser extension.
What is definition list?
A definition list (`<dl>`) is an HTML structure designed to pair terms with their descriptions — for example, a product's "Material: Cotton" or "Size: Large." The rules for what goes inside a `<dl>` are strict: it may only contain `<dt>` (definition term) elements and `<dd>` (definition description) elements, optionally wrapped in `<div>` groupings. When other tags or loose text are placed directly inside a `<dl>`, the list is considered malformed. Screen readers and assistive technologies rely on this structure to announce the relationship between a term and its value to users who cannot see the page visually. WCAG Success Criterion 1.3.1 ("Info and Relationships") requires that structure conveyed visually is also conveyed in the code.
Screen reader users — including many customers with visual impairments — depend on correctly structured definition lists to understand product specifications, FAQs, shipping details, and other paired information. A malformed `<dl>` causes screen readers to either skip content or announce it in a confusing, meaningless order, making it impossible for those customers to complete a purchase. Beyond conversions, non-compliance with WCAG 1.3.1 carries real legal risk: accessibility lawsuits against ecommerce stores are rising sharply, and a broken definition list is exactly the kind of machine-detectable violation that appears in demand letters. Fixing it also signals code quality to search engines, which increasingly factor accessibility into rankings.
See the complete Definition list guide for every platform and the full background.
Not sure if your Squarespace store has this?
Run a free SEOLZ scan — we’ll find definition list and every other issue across your whole site.
Scan my site free