How to fix common accessibility problems
Short, practical guides with code examples for the problems we find most often.
By platform
- Accessibility on Shopify: where to fix common problems
- Accessibility on WordPress and WooCommerce: where to fix common problems
- Accessibility on Wix: where to fix common problems
- Accessibility on Squarespace: where to fix common problems
- Accessibility on Webflow: where to fix common problems
- Accessibility on Joomla: where to fix common problems
- Accessibility on Drupal: where to fix common problems
By problem
- ARIA attributes not allowed on element
- ARIA attributes that are not allowed here
- ARIA items outside their container
- ARIA roles missing required attributes
- ARIA widgets missing their child roles
- Button name differs from its visible text
- Buttons with no text
- Clickable elements inside each other
- Custom buttons or menu items without a name
- Custom input fields without a name
- Definition lists built incorrectly
- Dropdowns without labels
- Embedded objects without text
- Empty headings
- Expandable sections without a label
- Form fields without labels
- Headings skip levels
- Hidden elements can get focus
- Iframes that trap keyboard users out
- Iframes without a title
- Image buttons without text
- Image map areas without text
- Images made with role="img" without text
- Images missing alt text
- Input buttons without text
- Invalid ARIA roles
- Invalid ARIA values
- Invalid language on page parts
- Invalid page language code
- Links only shown by colour
- Links with no text
- List items outside a list
- Lists built incorrectly
- Low colour contrast
- Meters without a name
- Missing page language
- Misspelled ARIA attributes
- No way to skip repeated content
- Page has no title
- Page locked to one screen orientation
- Page refreshes or redirects by itself
- Progress bars without a name
- Scroll areas not reachable by keyboard
- Sound plays automatically
- SVG images without text
- Table cells point to wrong headers
- Table headers with no data
- Terms outside a definition list
- Text spacing cannot be adjusted
- Toggles and checkboxes without a name
- Tooltips without text
- Touch targets too small
- Videos without captions
- Whole page hidden from screen readers
- Wrong autocomplete values
- Zooming is blocked