Fixing Issues

Fix the Most Common Accessibility Errors

Practical fixes for the errors AccessBell finds most often: missing alt text, unlabeled fields, low contrast, empty links and buttons, headings and page language.

Table of contents

A small number of issues account for most of what automated tests find on the web. Fix these and your score will rise quickly. Each issue in your dashboard also includes copyable code examples.

Images Without Alternative Text (WCAG 1.1.1)

Screen readers cannot describe an image without an alt attribute.

  • Describe what the image is for, not what it looks like: alt="Download the price list" for a linked icon.
  • Use alt="" for decorative images so they are skipped.
  • Do not start with “Image of”.

Form Fields Without Labels (WCAG 1.3.1, 4.1.2)

Placeholder text is not a label. It disappears while typing and is not reliably announced.

<label for="email">Email address</label>
<input id="email" type="email" autocomplete="email">

Low Color Contrast (WCAG 1.4.3)

Normal text needs a contrast ratio of at least 4.5:1 with its background. Large text, at least 24px or 19px bold, needs 3:1. Fix the color in your design tokens or CSS variables so every component that uses it improves at once. Check hover, focus and placeholder states too.

Icon-only links and buttons need a text name:

<button type="button" aria-label="Close dialog">
  <svg aria-hidden="true" focusable="false">...</svg>
</button>

Avoid vague link text such as “Click here”. Say where the link goes: “Download the 2026 report”.

Heading Order (Best Practice, Supports WCAG 1.3.1)

Use one h1 per page and do not skip levels, for example from h2 to h4. If you want a heading to look smaller, change its CSS rather than its level.

Missing Page Language (WCAG 3.1.1)

Add lang to the html element so screen readers pronounce the page correctly:

<html lang="en">

Missing Page Title (WCAG 2.4.2)

Give every page a unique <title> that starts with the page topic, for example “Pricing - Example Co”.

Zoom Disabled (WCAG 1.4.4)

Remove maximum-scale=1 and user-scalable=no from the viewport meta tag, so people can pinch to zoom.

After Fixing

Deploy the change and select Scan now on the domain. For a deeper walkthrough of every WCAG 2.2 requirement, see our WCAG 2.2 checklist.

Sources and Further Reading

Still Need Help?

Search the Help Center or send us a message. We reply within one business day.

Contact support

Ready to Try AccessBell?

Start a 3-day free trial to monitor your domain, or run a free one-page scan right now with no sign-up.

Then $29/mo per domain. Cancel anytime.