Decorative Images: When alt="" Is the Right Choice
Also called: Ornamental images, Presentational images, Null alt text
Definition
Decorative images are images that are pure decoration or only used for visual formatting and add no information to the page. WCAG 1.1.1 requires that they are implemented in a way that assistive technology can ignore, for example with an empty alt attribute or as a CSS background.
Decorative images are the flourishes, divider lines, background textures and mood photos that make a page look good but say nothing a reader would miss. For screen reader users, the best description of such an image is no description at all: an empty alt="" tells the screen reader to skip it. A divider announced as "graphic, line-separator-final-2.png" is noise, not information.
What it means
WCAG 1.1.1 Non-text Content (Level A, WCAG 2.2) requires a text alternative for all non-text content – except in a few listed situations. One of them is "Decoration, Formatting, Invisible": if non-text content is pure decoration, is used only for visual formatting, or is not presented to users, then it is implemented in a way that it can be ignored by assistive technology.
The hard part is deciding. Ask: would a reader lose information or function if the image were gone?
| Image | Decorative? | Right markup |
|---|---|---|
| Divider line, ornament, background pattern | Yes | alt="" or CSS background |
| Photo next to text that already says the same | Usually yes | alt="" |
| Icon next to a visible word, e.g. a trash can beside "Delete" | Yes | alt="" or aria-hidden="true" on the icon |
| Logo that links to the homepage | No | alt="Company name – home" |
| Chart, product photo, image of a person in the news | No | A real alt text |
W3C names two techniques for decoration: H67 (null alt text and no title attribute on img elements that assistive technology should ignore) and C9 (using CSS to include decorative images).
Examples
<!-- Decorative: skipped by screen readers -->
<img src="/img/wave-divider.svg" alt="">
<!-- Icon beside a visible label: hidden, the text names the button -->
<button type="button">
<svg aria-hidden="true" focusable="false">…</svg>
Delete
</button>
<!-- Pure decoration as CSS background -->
<section class="hero" style="background-image: url(/img/texture.jpg)">
<h2>Our workshop</h2>
</section>The img has an empty alt and no title, as H67 describes. The icon is hidden because the word "Delete" already names the button – a reader gets the accessible name once, not twice.
Use alt="" for images that add nothing, move pure decoration into CSS, hide icons that sit next to their own label, and write a real description whenever an image carries content or is the only content of a link or button.
Leave out the alt attribute, write "decoration" or "image" as alt text, give a decorative image a title, or mark a linked logo or an informative chart as decorative.
How to check decorative images
Questions
What is a decorative image?
An image that is pure decoration or only used for visual formatting and adds no information. If a reader would lose nothing when it is removed, it is decorative.
How do I mark an image as decorative in HTML?
Give the img element an empty alt attribute (alt="") and no title. Images that are only decoration can also be added through CSS. Inline SVG icons next to text are often hidden with aria-hidden="true".
Is alt="" the same as a missing alt attribute?
No. alt="" tells assistive technology to ignore the image. Without the attribute, many screen readers announce the file name, which is a failure of WCAG 1.1.1.
Should a logo have empty alt text?
Usually not. A logo identifies the company and often links to the homepage, so it needs alt text such as the company name. It is decorative only when the same name appears right next to it in the same link.
Can allyWay fix decorative images automatically?
Yes. When allyWay's AI finds an image purely decorative, it gives it an empty description so screen readers skip it, and images your website already marks as decorative are left as they are. The fix is applied by the allyWay script, so your code and theme stay unchanged, and you can change any decision back. Start for free and let AI sort out automatic fixes for your images.
Related terms
Alt text
Alt text is a short written description of an image. Screen readers read it aloud, and browsers show it when the image can't load – so people who can't see the image still get its meaning.
Read definition: Alt textMissing Alt Attribute: Error Explained and Fixed
A missing alt attribute means an img element (or an image button or image map area) has no alt attribute at all. Assistive technology cannot tell whether the image is informative or decorative and may read out the file name instead.
Read definition: Missing Alt Attribute: Error Explained and FixedImages of Text: Use Real Text Instead
Images of Text is WCAG success criterion 1.4.5. If the technology can achieve the same visual presentation, information is conveyed with real text rather than with text rendered into an image – unless the image can be customized or the presentation is essential.
Read definition: Images of Text: Use Real Text InsteadScreen Reader: How It Reads Websites and What It Needs
A screen reader is assistive software that reads the content and controls of a screen aloud or outputs them on a braille display. It relies on the names, roles and states that a website exposes through the browser's accessibility tree.
Read definition: Screen Reader: How It Reads Websites and What It Needs