- Level
- A
- Since
- WCAG 2.0
- Entries
- 65 / 193
1.1.1 Non-text Content
Anything that is not text (an image, an icon, a chart) needs a text alternative that carries the same information.
/ What it requires
Every image, icon, chart, audio clip or other piece of content that is not text needs a text alternative that does the same job. A screen reader cannot describe pixels: it reads the alt attribute, the accessible name, or nothing. When the alternative is missing, a blind visitor hears a file name or the word image, a voice control user cannot name the button, and somebody on a slow connection with images switched off sees an empty box.
The line is purpose, not appearance. A photo that carries information needs a description of that information; a linked logo needs the destination; a purely decorative flourish needs an empty alt so assistive technology skips it. The criterion names its own exceptions: controls and inputs need a name, audio and video need at least a descriptive label, tests and sensory experiences need a brief identification, and a CAPTCHA needs a text label plus an alternative form for a different sense.
/ How pages fail it
- An img element has no alt attribute at all, so a screen reader falls back to the file name.
- The alt text is a file name or a placeholder such as image, photo or IMG_2043.jpg.
- A linked image or an icon button has an empty alt, which leaves the link or button with no name.
- A chart or infographic is described as chart, and none of the figures it shows are available in text.
- Decorative images carry long descriptions, so the page is read out with noise between every paragraph.
/ How to check it yourself
- Right-click an image, choose Inspect and look for the alt attribute. Read what it says as if you could not see the picture.
- Ask of each image: if this text replaced it, would a visitor miss anything. For decoration the right answer is alt="".
- Start a free screen reader (NVDA on Windows, VoiceOver on macOS) and tab to every linked image and icon button. Each one should announce where it goes or what it does.
- Check charts, maps and infographics for the same data in text, next to the graphic or linked from it.
- Search the stylesheet for background-image on elements that carry meaning. A CSS image has no alt, so the information must also exist in the markup.
/ How to fix it
- Add an alt attribute to every img element. Describe what the image contributes in that place, not what it looks like in general.
- For decoration use alt="" (empty, with no space), or move the image into CSS as a background-image.
- When an image is the only content of a link or a button, write the alt as the destination or the action, for example Home or Search.
- For inline SVG add role="img" and an aria-label. For an icon font put aria-label on the button and aria-hidden="true" on the glyph.
- Give a complex graphic a short alt that names it, and put the full data in a table or a paragraph beside it.
/ What our scanner checks
Our static pass counts img elements with no alt attribute, unless they carry role presentation or none. The rendered pass repeats that for visible images and flags alt text that is a file name or a placeholder word. HTML_CodeSniffer and axe-core add linked images without alt, an empty alt with a title, and object elements without a text alternative. None of them can judge whether a description is accurate.
/ Who fails it, in our own measurements
One page per body, measured by automated checks on a weekly schedule. Any body that has fixed something since the last sweep will show it at the next one, and every entity page carries a right of reply.
/ Questions about this criterion
Does every image need alt text?
Every img element needs an alt attribute, but not every image needs a description. An image that adds information gets a short text saying what it adds. An image that is pure decoration gets an empty attribute, alt="", which tells a screen reader to skip it. Leaving the attribute out is the failure, because the file name may be read out instead.
How long should alt text be?
WCAG sets no character limit. The test is whether the text serves the same purpose as the image in that place, so one short sentence is usually enough. When an image holds more than a sentence can carry, such as a chart or a diagram, keep the alt short and put the full description or the data in the page text beside it.
What is the difference between a missing alt and an empty alt?
A missing attribute leaves assistive technology guessing, and a screen reader may announce the file name or the link address. An empty attribute, alt="", is a deliberate statement that the image is decorative and should be ignored. Sighted visitors notice neither. Only the first is a failure of 1.1.1 by itself; the second fails when the image did carry information.
