Skip to main content
Accessibility Guides

How to Build an Accessibility Guide That Survives Contact with Real Users

A practitioner's walkthrough for creating accessibility guides that actually help screen reader users, based on real survey data and hands-on testing.

You're typing into a search bar: "How do I make my website accessible for screen reader users?" And you're probably getting a pile of generic checklists that tell you to add alt text and call it a day. We've been there. This guide is for developers, designers, and content folks who've been handed the accessibility task and need something that works in the real world, not just in a compliance report.

Here's the thing: accessibility isn't a one-time fix. It's an ongoing practice. And the best way to start is by building an accessibility guide that's rooted in how people actually use assistive tech. We'll walk through a practical, hands-on method, using data from the 2024 WebAIM Screen Reader User Survey and other hard numbers. By the end, you'll have a guide that's not just a document, but a living tool.

1. Who Is This For?

This is for anyone who owns a website or app and has ever thought, "We should probably do something about accessibility." Maybe you're a front-end dev, a UX designer, or a project manager. You don't need to be an expert. You just need to be willing to test with real assistive technology, listen to real users, and accept that your beautiful design might be a nightmare for someone using a screen reader.

We're going to show you how to create an accessibility guide that focuses on the practical steps that matter most, based on what screen reader users actually struggle with. Because let's face it: 95.9% of home pages have detectable WCAG failures (WebAIM Million), and the average page has 56.1 errors. That's not a small problem. It's an epidemic.

2. Start with the User, Not the Guidelines

Before you write a single line of your guide, you need to know who you're writing for. The WebAIM survey gives us a clear picture: 76.6% of screen reader users are blind, and 19.9% have low vision. And 5.3% are both deaf and blind. That last group is often forgotten, but they're real, and they might rely on braille output. In fact, 38% of respondents use braille with their screen reader (WebAIM). So your guide can't just be about visual design; it has to address the full spectrum of how people interact with content.

Here's a concrete example: if you're building a form, you can't just put a placeholder that says "Enter your name." A screen reader user might not even know that's a field. They need a real associated with the input. That's a basic fix, but it's one that 51% of home pages get wrong (WebAIM Million). Your guide should explicitly call out these patterns, with code examples and testing steps.

When you're writing your guide, start by outlining the top tasks a user might do on your site — like searching, buying, or contacting support. Then, for each task, list the assistive tech you'll test with. That's your roadmap.

3. Choose Your Screen Readers Wisely

You can't test with everything, so you need to prioritize. Based on the 2024 WebAIM survey, here's the landscape: JAWS is the primary screen reader for 40.5% of users, and NVDA for 37.7%. But when you look at *any* use (not just primary), NVDA leads at 65.6%, with JAWS at 60.5% (WebAIM). So if you're only going to test with one, NVDA is a smart choice — it's free, open source, and runs on Windows. But you should also test with VoiceOver on mobile, because 70.6% of respondents use it on their phones (WebAIM).

Here's a quick comparison table to help you decide:

Screen Reader Platform Cost Primary Use Any Use
JAWS Windows Commercial 40.5% 60.5%
NVDA Windows Free 37.7% 65.6%
VoiceOver Apple (iOS/macOS) Built-in Not reported 70.6% (mobile)
TalkBack Android Built-in Not reported 34.7% (mobile)
Narrator Windows Built-in 0.7% 37.3%

Numbers are from the WebAIM 2024 Screen Reader User Survey (WebAIM).

Your guide should include a section that says: "We test with NVDA on Windows, VoiceOver on iPhone, and TalkBack on Android. If you have a JAWS license, great, but you can also rely on NVDA for most issues." That's a concrete, defensible policy.

4. The Seven-Step Testing Walkthrough

Now we're getting to the meat. Here's a step-by-step process you can bake into your guide:

  1. Turn on the screen reader and navigate your page using only the keyboard. Tab through links, buttons, and form fields. If you can't reach something, that's a fail.
  2. Listen to the reading order. Does the screen reader announce things in a logical order? If you've used CSS to visually rearrange elements, the screen reader might be reading them in a nonsensical order.
  3. Check all images. Do they have meaningful alt text? If an image is purely decorative, it should have empty alt text so the screen reader skips it. The WebAIM Million found that 53.1% of home pages have missing alt text — don't be one of them.
  4. Test forms thoroughly. Every input must have a label. When you tab into a field, does the screen reader announce the label and the required state? If not, users are lost.
  5. Verify contrast. Low contrast text is the #1 issue, affecting 83.9% of home pages (WebAIM Million). Use a contrast checker and aim for WCAG AA (4.5:1 for normal text).
  6. Try to complete a core task — like purchasing a product or contacting support — using only the screen reader. Write down every obstacle you hit.
  7. Ask a real user. If you can, recruit a screen reader user to test your site. Nothing replaces direct feedback. If you can't, at least watch videos of screen reader users navigating similar sites.

This walkthrough should be the heart of your guide. It's not about checking boxes; it's about experiencing your site the way a user would.

5. What Can Go Wrong (and How to Avoid It)

Here's the warning: you will be tempted to rely on automated testing tools. They're useful, but they're not enough. The WebAIM Million uses automated checks and still finds that 95.9% of home pages fail. But automated tools can't tell you if your page makes sense when read aloud. They can't feel the frustration of tabbing through 50 links to find the one you need.

So, what's the biggest pitfall? It's thinking that accessibility is a checklist. You'll create a guide that says "add alt text" and "use proper headings," but then you'll ship a page where the headings are all styled as

s, and the alt text is "image1.jpg." That's useless.

Instead, your guide should include examples of good and bad code, and it should be updated as you learn. Treat it like a living document, not a one-time deliverable.

Another thing that can go wrong: ignoring mobile. 91.3% of screen reader users use a screen reader on a mobile device (WebAIM). That's huge. But many guides focus only on desktop. Make sure your testing includes mobile Safari with VoiceOver and Chrome with TalkBack.

And don't forget about deaf and hard of hearing users. 1.5 billion people globally have hearing loss (World Health Organization), and 15% of American adults report some trouble hearing (NIDCD). So captions and transcripts are non-negotiable. Your guide should cover those too.

6. Keep Your Guide Alive

Finally, an accessibility guide is only as good as its upkeep. Set a schedule: review it every quarter, and whenever you redesign a page or add a new feature. Track your progress. Maybe you start with 50 errors per page, and after a month you're down to 10. That's worth celebrating.

Here are a few quick tips to keep in mind:

  • Use semantic HTML — it's half the battle.
  • Test with a real screen reader at least once per sprint.
  • Make accessibility a part of your definition of done, not an afterthought.

Quick tip: Start with one page — your homepage or a key landing page — and make it flawless. Then expand to other templates.

What I'd Actually Do

Here's my honest opinion: if you're starting from scratch, don't try to boil the ocean. Pick NVDA (free, and the most used screen reader overall) and test on Windows with Chrome and Firefox. Then, download VoiceOver on an iPhone and test your mobile experience. That covers the vast majority of users. You don't need a JAWS license right away. And whatever you do, don't just run an automated tool and call it done. That's how you end up with 96% of pages failing, like the WebAIM Million found.

Create a simple, 10-page guide that includes the testing walkthrough above, with code snippets and screenshots of your own site. Share it with your team, and make it part of your onboarding. When someone asks, "How do I make this accessible?" you can point to your guide. That's the goal.

We've been doing this for years, and it works. The key is to start small, test with real tools, and never stop learning. Your users will thank you — even if they never say it, because they didn't have to struggle.

Sources

  • WebAIM Screen Reader User Survey - https://webaim.org/projects/screenreadersurvey10/
  • WebAIM Million - https://webaim.org/projects/million/
  • World Health Organization (Deafness and hearing loss) - https://www.who.int/news-room/fact-sheets/detail/deafness-and-hearing-loss
  • NIDCD Quick Statistics About Hearing - https://www.nidcd.nih.gov/health/statistics/quick-statistics-hearing

Share this article:

Comments (0)

No comments yet. Be the first to comment!