Missing alt text is the first thing to fix, because it can leave a screen reader reading out a file name. Everything else is polish by comparison.
That ordering is a suggestion, not something the sources rank. The mistakes below come from Section508.gov, WebAIM and MDN.1
Leaving the attribute off
WebAIM, an accessibility group, says "Every image should have an alt attribute", even if it's empty.2 MDN says that when the attribute isn't there, some screen readers "may announce the image's file name instead". That's confusing if the file name says nothing about the picture.3
A file name that doesn't match the picture's content tells a listener nothing.
Using the file name as the alt text
Section508.gov lists this as a common error. The alt text is just the file name or path instead of a description.1 Open your editor's alt box on a few images and look at what's in it.
Too short, or too long
Section508.gov names both. Text that's too short doesn't describe the relevant content, and text that's too long describes unnecessary information.1 "Photo" is too short. A whole paragraph about every object in the frame is too long.
Describing the look, not the point
Another entry in Section508.gov's list is writing text that describes the image visually but not the part that explains why the image is there.1 A photo on a staff page is there to show who someone is, so the name matters more than the shirt colour.
Repeating the page
Alt text that echoes the paragraph beside it makes a listener hear everything twice. Section508.gov lists "The text repeats information from the main text" as a common mistake.1
Starting with "image of"
WebAIM says alt text should not include phrases like "image of" or "graphic of". Screen readers already announce the graphic.2 MDN's example of a poor alt is the single word "image".3
Stuffing in sales lines or keywords
WebAIM calls this a mistake too often seen: "using alt to inject extraneous information (or information directed to search engines)".2 A string of search phrases isn't a description. A listener hears all of it.
Using the title attribute instead
Don't treat a "title" box as a second alt box. MDN says the title attribute "is not an acceptable substitute for the alt attribute". It also says not to repeat the alt value in the title, because some screen readers may announce the same text twice.3
Describing decoration
A divider line or a background swirl doesn't need a description. See the page on leaving alt empty. Section508.gov says that for a decorative laptop photo, alt text saying a person is typing on a laptop is unhelpful.1
Wrong language
Section508.gov's list includes alt text in a different language from the on-screen text, such as English alt text on a Spanish page.1
Where to start on a real site
Work through a handful of pages first. Your home page, your contact page and your top services page are sensible places. To find what's already there, use the checking routine. For what to put instead, see writing for a normal photo.
Sources used
- Authoring Meaningful Alternative Text, Section508.gov (US General Services Administration)
- WebAIM: Alternative Text, WebAIM
- <img>: The Image Embed element, MDN Web Docs (Mozilla)
