Mastering the Art of Decorative Alt Text for Web Accessibility
Mastering the Art of Decorative Alt Text for Web Accessibility
Why Images Decorative Alt Text Can Make or Break Your Accessibility Compliance
Images decorative alt text is one of the most misunderstood — and most audited — areas of WCAG compliance. Get it wrong, and screen reader users are bombarded with useless noise. Get it right, and your site becomes genuinely easier to use for everyone.
Here is the quick answer:
| Situation | What to do |
|---|---|
| Image adds no useful information | Use alt="" (empty alt attribute) |
| Image content is already described in nearby text | Use alt="" to avoid repetition |
| Image is inside a link with descriptive text | Use alt="" so the link text does the work |
| Image conveys meaning not found elsewhere | Write descriptive alt text |
| Image is a decorative SVG | Use aria-hidden="true" |
| Image is a CSS background | No alt needed — it is already hidden from screen readers |
The rule of thumb: when in doubt, provide more information rather than less. But for truly decorative images, silence is the most accessible choice.
This is not just a best-practice issue. Under WCAG Success Criterion 1.1.1, failing to handle decorative images correctly is a real compliance violation — and it shows up in accessibility audits constantly.
I’m Matthew Post, a web developer and accessibility specialist with nearly three decades of experience, and I’ve personally reviewed hundreds of sites where improper handling of images decorative alt text was quietly creating both ADA liability and a poor screen reader experience. In the sections below, I’ll walk you through exactly how to identify, code, and test decorative images so your site stays compliant and usable.
Defining Images: Decorative Alt Text vs. Informative Content
At WCAG Pros, we often see developers get paralyzed by a simple question: “Is this image important?” To answer that, we look to Guideline 1.1.1 Non-text Content, which requires that all non-text content has a text alternative. However, the guideline specifically allows for “null” alt text when an image is purely for visual styling or “eye candy.”
A decorative image is a visual element that doesn’t add additional context or information that allows the user to better understand the page’s content. Think of it as the wallpaper in a room—it makes the room look nice, but you don’t need to describe the floral pattern to understand what’s happening in the meeting taking place there.
To help our clients, we often refer them to the W3C Image Decision Tree, a fantastic tool for determining an image’s purpose.
| Image Type | Purpose | Screen Reader Requirement |
|---|---|---|
| Decorative | Visual flair, ambiance, or redundancy. | Must be ignored (null alt). |
| Informative | Conveys a concept, emotion, or data. | Needs descriptive text. |
| Functional | Initiates an action (like a button or link). | Must describe the destination or action. |
When to use images decorative alt text
There are three primary situations where we recommend using images decorative alt text (specifically, the null attribute):
- Redundant Information: If the image is a Source of decorative image like a “Social Media” icon placed right next to a heading that says “Social Media,” describing the icon is redundant.
- Adjacent Text: When the image is fully described by the text immediately surrounding it. For example, a photo of a sleeping dog next to a paragraph titled “Why Dogs Sleep So Much.”
- Visual Ambiance: Abstract shapes, gradients, or stock photos used simply to break up text or add “vibe” to a landing page without contributing to the narrative.
Identifying functional vs. decorative icons
This is where it gets tricky. An icon can be decorative in one context and functional in another.
Take a “Home” icon (the little house). If that icon is inside a navigation link that also contains the word “Home,” the icon is decorative. The link text handles the accessibility. However, if the icon is the only thing inside the link, it is now a functional image. It must have alt text like alt="Home" so the user knows where the link goes.
Always check if the clickable area or the button labels already provide the necessary information. If they do, mark that icon as decorative to avoid cluttering the screen reader’s output.
Technical Implementation: How to Code Null Alt Text
When we perform Quick Fixes to Improve Your Website’s Accessibility Today, the most common HTML correction we make is adding the null alt attribute.
In HTML, the tag must have an alt attribute to be valid. For decorative images, we use an empty or “null” value: alt="".
When a screen reader encounters alt="", it understands that the image is intentionally hidden. It will skip over the element entirely. If you omit the attribute entirely, the screen reader may try to be “helpful” by reading the filename (e.g., “IMG9842final_v2.jpg”), which is a major source of screen reader fatigue.
Using ARIA for images decorative alt text
While alt="" is the gold standard for standard images, modern web design uses SVGs and complex components that require ARIA attributes.
role="presentation": This tells assistive technology to strip away the “image” semantics of the element. It’s like telling the screen reader, “Treat this as if it’s just a plain div with no meaning.”aria-hidden="true": This removes the element and all its children from the accessibility tree entirely.
For inline SVGs—which don’t support the alt attribute—we recommend using aria-hidden="true". To dive deeper into the nuances, you can check out this guide on the difference between role=”presentation” and aria-hidden=”true”.
Common mistakes to avoid in HTML
Even with the best intentions, we see these three mistakes during our audits:
- Missing Alt: As mentioned, this leads to the dreaded filename announcement.
- Keyword Stuffing: Never put SEO keywords like “best plumber in Norco CA” into the alt text of a decorative divider. This is a violation of ACT Rules: Image not in the accessibility tree.
- The “Image of” Prefix: Screen readers already announce “Graphic” or “Image.” Writing
alt="Image of a decorative swirl"results in the user hearing “Graphic, Image of a decorative swirl.” Just usealt=""if it’s decorative, or describe the subject directly if it’s informative.
Real-World Examples of Decorative Images
Let’s look at some visuals you likely use every day. Stock photos that “catch the eye” at the top of a blog post are often purely decorative. Similarly, page borders or horizontal floral dividers are classic candidates for null alt text.
Another common example is the Source of the quick brown fox jumps over the lazy dog image. If this image is used to demonstrate a font style, and the text is already written in the caption, the image itself becomes decorative.
Handling Decorative SVGs and CSS Backgrounds
Vector graphics (SVGs) are popular because they are crisp at any size. If you use an SVG as a decorative icon next to a text label, SVGs are ignored by some screen readers by default, but others might try to read the tag inside the SVG code. To be safe, always apply aria-hidden="true" to decorative SVGs.
For CSS background images, you’re in luck! Assistive technology generally ignores images loaded via the background-image property. If an image is truly decorative, moving it to CSS is a clean way to handle it. If you are using CSS pseudo-elements like ::before to add icons, you can use the syntax content: "" / ""; to provide a null alternative within the stylesheet itself, as noted in the Decorative Images | Web Accessibility Initiative (WAI) tutorials.
Contextual examples: When the same image changes roles
Context is everything in accessibility. Consider the Source of King Henry VIII of England Image.
- Scenario A: On a history blog post about Tudor fashion, this image is informative. The alt text should describe his ornate clothing and stern expression.
- Scenario B: On a page about “Famous Kings,” where his name “King Henry VIII” is written in a large heading right below the picture, the image is decorative. The text has already identified him; the image is just visual flair.
Platform-Specific Considerations for Decorative Visuals
Accessibility isn’t just for websites; it’s for documents, too. If you’re creating reports or presentations, you need to handle visuals correctly in those formats.
Marking images as decorative in Microsoft 365
Microsoft has made this surprisingly easy. In apps like Word, Excel, and PowerPoint, you don’t need to write code.
- Right-click the image.
- Select “View Alt Text.”
- Check the box that says “Mark as decorative.”
This grays out the text box and tells screen readers to skip the object. We recommend checking Microsoft Office Help & Training for the latest updates on these features. Be wary of AI-generated descriptions; Microsoft often suggests them automatically, but if the image is decorative, you should ignore the AI and just check the “decorative” box. You can find more tips at Microsoft 365 help & learning.
Handling decorative elements in PDFs and ePubs
For PDFs, decorative images must be “Artifacted.” This is a technical term in PDF tagging that tells the reading order to skip the element. In professional tools like Adobe Acrobat, you can right-click a tag and change it to an “Artifact.”
In ePub files (used for e-books), the rules are similar to HTML. According to the Accessible Publishing Knowledge Base: HTML: Images, decorative images should use alt="" and, for maximum compatibility, role="presentation".
Frequently Asked Questions about Decorative Alt Text
What happens if I omit the alt attribute entirely?
This is one of the 5 Common Accessibility Issues on Small Business Websites. When the attribute is missing, the screen reader doesn’t know if you forgot it or if it’s decorative. Most will announce the filename, which is a poor user experience and a technical WCAG violation.
Can I use “decorative” as the alt text string?
Please don’t! We see alt="decorative image" or alt="spacer" all the time. This actually makes the experience worse because the screen reader will say “Graphic, decorative image.” The user still has to listen to it. Use an empty string alt="" to ensure total silence.
How do I test if an image is truly decorative?
Our favorite trick at WCAG Pros is the “Text-Only Test.” Imagine your website has no images at all. Does the page still make sense? Does it lose any meaning? If the answer is “no,” the image is likely decorative. For a full breakdown of testing methods, see The Ultimate Website Accessibility Testing Checklist for 2026.
Conclusion
Mastering images decorative alt text is about respect for the user’s time and attention. By correctly identifying and coding decorative images, you remove the “noise” of the internet for those using assistive technology.
At WCAG Pros, we specialize in helping businesses in Norco, CA, and beyond achieve full ADA compliance. Whether you need a comprehensive page-by-page audit of all 54 WCAG points or help with remediation and code fixes, we’re here to ensure your digital presence is inclusive for everyone.
Ready to ensure your site is fully accessible? More info about WCAG Pros services is just a click away. Let’s make the web better, one alt="" at a time.
Read more website accessibility articles
Get Help With Your Website
We'll follow up with info about:
- The process
- Cost
- Timeline
We promise to respect your privacy, and never abuse the information you provide. We will not sell or rent your information to any third party.
By submitting this form, you consent to receive SMS messages and/or emails from SEM Dynamics LLC, dba WCAG Pros. To unsubscribe, follow the instructions provided in our communications. Msg & data rates may apply for SMS. Your information is secure and will not be sold to third parties.

