Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

Someone complained that my website is not accessible and I do not know where to start

Short answer

Accessibility complaints usually point to the WCAG guidelines, the international standard from W3C. Do not ignore the message, and do not reply with promises. Keep it, ask your own legal adviser how to respond, and in parallel have the site tested against WCAG so you know which real barriers exist. This page is not legal advice.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • I received an email or letter saying my site is not accessible.
  • A customer told me they could not use my forms or checkout.
  • A client or tender asks for WCAG compliance.
  • An automated scan reports hundreds of issues and I cannot tell which matter.
  • I added an accessibility widget and still got a complaint.

Why does this happen?

  1. There is a named standard for it

    W3C's Web Content Accessibility Guidelines (WCAG) are an international standard for making web content accessible to people with disabilities. Versions 2.0, 2.1 and 2.2 exist, and W3C encourages using the latest, 2.2. Success criteria are assigned to level A, AA or AAA.

  2. Sites are often built without testing for it

    Missing image descriptions, forms without labels, low colour contrast and menus that cannot be used with a keyboard are common, because designs are checked by sight and with a mouse.

  3. Templates and plugins add barriers

    Sliders, popups, page builders and embedded widgets may not work with screen readers or a keyboard, and every new section can add more.

  4. Automated scans see only part

    Tools can detect some issues, such as missing text alternatives, but cannot judge whether a page makes sense to use with assistive technology. A real check needs manual testing.

  5. The legal side differs by place

    What a complaint means for you depends on your country, sector and the sender. That is a question for a qualified lawyer, not a developer.

What can I do about it today?

  1. Keep the message and do not delete anythingSave the original email or letter with its date.
  2. Do not reply with admissions or promisesTalk to a legal adviser in your country before answering.
  3. Ask what exactly the person could not doA specific page or task, such as the checkout, is easier to test and fix than a general statement.
  4. Try your key pages with a keyboard onlyUse Tab and Enter to move through the menu, a form and checkout. If you get stuck, note where.
  5. Do not rely on an overlay widget aloneA widget does not change the underlying page. Ask for a test of the page itself.

When should I bring someone in?

  • The complaint names deadlines or a legal process.
  • The barrier is in checkout, booking or login.
  • You do not know which template or plugin causes it.

How do I handle it?

  1. Test against WCAGI check key journeys against the success criteria, using automated tools and by hand with a keyboard and a screen reader.
  2. Rank by who is blockedBarriers that stop a task, such as ordering or contacting you, come first.
  3. Fix at the sourceFixes go into the templates and components, so they hold for new pages.
  4. Retest and write it downYou get a short list of what was found, what was fixed and what remains.
  5. Stay out of the legal questionI do not tell you whether you are compliant in law or how to answer the sender. A lawyer does that.

The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.

What do owners ask about this?

Does passing WCAG protect me legally?

I cannot say. That depends on your jurisdiction and facts, and needs a lawyer.

Which WCAG level do I need?

That is set by a contract, law or your own policy. W3C describes levels A, AA and AAA but the page does not say which one you must meet.

Can an overlay fix it?

An overlay does not change the underlying code, and real fixes are made on the pages themselves.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.