How to make a website accessible
Dan Counsell · Founder of Realmac SoftwareUpdated
We’ve made RapidWeaver, a website builder for Mac, since 2004. Each guide works with any tool, then shows how in RapidWeaver Elements.
An accessible website works for people who can’t see well, can’t use a mouse, can’t hear video, or find dense pages hard to read. It’s the right thing to do, it helps everyone, and in many places it’s the law. The European Accessibility Act applies to many businesses that sell to people in the EU.
The usual standard to aim for is WCAG 2.1 level AA.
Structure
- One H1 per page, then H2s and H3s in order. Screen reader users jump between headings to find their way.
- Use real lists, real buttons and real links, not styled text that looks like them.
- Write link text that makes sense alone. “Read our pricing” beats “click here”.
Images and alt text
Alt text describes an image for people who can’t see it. Say what the image shows and why it’s there, in a sentence.
- Good: “Chef plating a mushroom risotto in the café kitchen.”
- Not useful: “IMG_4032.jpg” or “image”.
- Decorative images, such as a background texture, should have empty alt text so screen readers skip them.
Colour and text
- Contrast. Body text needs a contrast ratio of at least 4.5 to 1 with its background. Light grey on white often fails.
- Don’t rely on colour alone. A red border on a form field should come with a message saying what’s wrong.
- Readable size. Body text of 16 pixels or more, and pages that still work when zoomed to 200%.
Keyboard and focus
Unplug your mouse, or just don’t touch the trackpad, and use Tab to move through a page. You should be able to reach and use every link, button and menu, and always see where you are.
Forms
- Every field has a visible label.
- Errors say what went wrong and how to fix it.
- Don’t use placeholder text as the only label; it disappears when you type.
Video and audio
- Add captions to videos, and a transcript for audio.
- Don’t autoplay anything with sound.
How to test
- WAVE (wave.webaim.org) flags missing alt text, contrast problems and empty links.
- Lighthouse in Chrome gives an accessibility score with fixes.
- VoiceOver is built in to every Mac. Press Command-F5 and listen to your page.
Accessibility in RapidWeaver Elements
RapidWeaver Elements writes semantic HTML and lets you choose the heading level of every Heading component. Set alt text for each image in its resource info, and check text and button colours in the Theme Studio. Forms have labels for each field. The accessibility chapter of our manual has a fuller checklist.
Questions about website accessibility
Is website accessibility a legal requirement?
In many countries, for many organisations, yes. The rules differ: the European Accessibility Act, the UK Equality Act and the Americans with Disabilities Act all reach websites in some cases. If you’re unsure, aim for WCAG 2.1 AA.
How do I write good alt text?
Describe what matters about the image in context, in one sentence. Leave out “image of”. If the image contains text, include that text.
Do accessibility overlays work?
Plugins that promise one-click accessibility don’t fix the underlying problems, and many disabled users find them get in the way. Fix the site itself.